diff --git a/documentation/docs/mcp/linux-mcp-server-mcp.md b/documentation/docs/mcp/linux-mcp-server-mcp.md new file mode 100644 index 00000000..113d94cd --- /dev/null +++ b/documentation/docs/mcp/linux-mcp-server-mcp.md @@ -0,0 +1,81 @@ +--- +title: Linux MCP Server Extension +description: Add Linux MCP Server as a goose Extension +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; +import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed'; +import CLIExtensionInstructions from '@site/src/components/CLIExtensionInstructions'; +import GooseDesktopInstaller from '@site/src/components/GooseDesktopInstaller'; +import GooseBuiltinInstaller from '@site/src/components/GooseBuiltinInstaller'; + +This tutorial covers how to add the [Linux MCP Server](https://github.com/rhel-lightspeed/linux-mcp-server) as a goose extension to enable AI assistants to run, discover, and troubleshoot complex issues on Linux systems. + +:::tip TLDR + + + [Install Linux MCP Server](https://rhel-lightspeed.github.io/linux-mcp-server/install/) + + + **Command** + ```sh + # Using uv (recommended) + uvx linux-mcp-server + ``` + + +::: + +## Configuration + +:::info +Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on your system to run this command, as it uses *uvx*. +::: + + + + + + + + + + + + + + + + +## 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 + +:::note 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. + +::: \ No newline at end of file diff --git a/documentation/static/servers.json b/documentation/static/servers.json index d36847d0..f005c46f 100644 --- a/documentation/static/servers.json +++ b/documentation/static/servers.json @@ -409,6 +409,34 @@ "endorsed": true, "environmentVariables": [] }, + { + "id": "linux-mcp-server", + "name": "Linux MCP Server", + "description": "Tools to allow LLM clients to interact with Linux systems remotely", + "command": "uvx linux-mcp-server", + "documentation": "https://rhel-lightspeed.github.io/linux-mcp-server/clients/#environment-variables", + "link": "https://github.com/rhel-lightspeed/linux-mcp-server", + "installation_notes": "Install using uvx package manager. Note: This is a read-only mcp server for discovering and interacting with remote/local systems.", + "is_builtin": false, + "endorsed": false, + "environmentVariables": [ + { + "name": "LINUX_MCP_USER", + "description": "Default username for SSH connections", + "required": false + }, + { + "name": "LINUX_MCP_SSH_KEY_PATH", + "description": "Path to SSH private key", + "required": false + }, + { + "name": "LINUX_MCP_VERIFY_HOST_KEYS", + "description": "Verify remote host identity via known_hosts", + "required": false + } + ] + }, { "id": "mbot-mcp", "name": "MBot",