mcp_linux_ssh

samdoran/mcp_linux_ssh

0 starsCommunity

Install to Claude Code

This server doesn't publish a one-line install command. Follow the setup in the source repository.

Summary

Enables running commands over SSH on remote Linux hosts, with logging and standalone executable support.

README.md

MCP Server to run commands over SSH #

⚠️ This is an early prototype. Use at your own risk. ⚠️

Getting started ###

python -m venv .venvs/mcp
.venvs/mcp/bin/python -m pip install -e .

Run the MCP server with .venvs/mcp/bin/mcp-linux-ssh

To have an MCP client run the application, point it at realpath .venvs/mcp/bin/mcp-linux-ssh.

Here's an example configuration for Claude Desktop:

{
    "mcpServers": {
        "linux_ssh": {
            "command": "/Users/sdoran/Developer/mcp_linux_ssh/.venvs/mcp/bin/mcp-linux-ssh",
            "env": {
                "TMPDIR": "/tmp"
            }
        }
    }
}

Create a standalone executable ###

Use [shiv][] to create portable executable.

mkdir build
shiv -o build/mcp_linux_ssh --console-script mcp-linux-ssh .

Logging ###

Commands and the hosts they are run on are logged to a local file that is rotated once it reaches five megabytes in size. The file location depends on the platform running the MCP server.

Linux: ~/.local/share/logs/mcp-linux-ssh.log

macOS: ~/Library/Logs/mcp-linux-ssh.log

[shiv]: https://shiv.readthedocs.io/en/latest/