Linux MCP Server Extension

This tutorial covers how to add the Linux MCP Server as a goose extension to enable AI assistants to run, discover, and troubleshoot complex issues on Linux systems.

TLDR

goose Desktop

Install Linux MCP Server

goose CLI

Command

# Using uv (recommended)
uvx linux-mcp-server

Configuration

info

Note that you'll need uv installed on your system to run this command, as it uses uvx.

goose Desktop

1. Launch the installer
2. Click Yes to confirm the installation
3. Click the button in the top-left to open the sidebar
4. Navigate to the chat

goose CLI

1. Run the configure command:

goose configure

2. Choose to add a Command-line Extension.

┌   goose-configure
│
◇  What would you like to configure?
│  Add Extension
│
◆  What type of extension would you like to add?
│  ○ Built-in Extension
│  ● Command-line Extension (Run a local command or script)
│  ○ Remote Extension (Streamable HTTP)
└

3. Give your extension a name.

┌   goose-configure 
│
◇  What would you like to configure?
│  Add Extension
│
◇  What type of extension would you like to add?
│  Command-line Extension
│
◆  What would you like to call this extension?
│  Linux MCP Server
└

4. Enter the command to run when this extension is used.

┌   goose-configure 
│
◇  What would you like to configure?
│  Add Extension
│
◇  What type of extension would you like to add?
│  Command-line Extension 
│
◇  What would you like to call this extension?
│  Linux MCP Server
│
◆  What command should be run?
│  uvx linux-mcp-server
└

5. Enter the number of seconds goose should wait for actions to complete before timing out. Default is 300 seconds.

┌   goose-configure 
│
◇  What would you like to configure?
│  Add Extension
│
◇  What type of extension would you like to add?
│  Command-line Extension
│
◇  What would you like to call this extension?
│  Linux MCP Server
│
◇  What command should be run?
│  uvx linux-mcp-server
│
◆  Please set the timeout for this tool (in secs):
│  300
└

6. Enter a description for this extension.

┌   goose-configure 
│
◇  What would you like to configure?
│  Add Extension
│
◇  What type of extension would you like to add?
│  Command-line Extension
│
◇  What would you like to call this extension?
│  Linux MCP Server
│
◇  What command should be run?
│  uvx linux-mcp-server
│
◇  Please set the timeout for this tool (in secs):
│  300
│
◆  Enter a description for this extension:
│  Tools for Linux system discovery and troubleshooting
└

7. Choose No when asked to add environment variables.

┌   goose-configure 
│
◇  What would you like to configure?
│  Add Extension 
│
◇  What type of extension would you like to add?
│  Command-line Extension
│
◇  What would you like to call this extension?
│  Linux MCP Server
│
◇  What command should be run?
│  uvx linux-mcp-server
│
◇  Please set the timeout for this tool (in secs):
│  300
│
◇  Enter a description for this extension:
│  Tools for Linux system discovery and troubleshooting
│
◆  Would you like to add environment variables?
│  No
│
└  Added Linux MCP Server extension

Example Usage

Follow the instructions on how to use the Linux MCP Server for system diagnostics and troubleshooting.

goose Prompt

My wifi connection is not working very well. Find the error messages in the system logs and diagnose the problem to help me fix it.

goose Output

Desktop

🤖 LLM output 🤖 I’ll help you diagnose your WiFi connectivity issues by examining the system logs for error messages related to your network interfaces and wireless connectivity. Let me start by gathering information about your system and checking the relevant logs.