Terminal SSH MCP Server

An MCP (Model Context Protocol) server that provides SSH and terminal access capabilities. This server enables interactive access to Railway containers and local shell execution through the MCP interface.

Features

• SSH Access: Connect to Railway containers via SSH with optional command execution
• Command Execution: Run shell commands locally with output capture
• File Operations: Read, write, and list files on the system
• Directory Listing: Browse directory structures
• Railway Integration: Direct SSH access to Railway services using project/environment/service IDs

Installation

Local Installation (for Cline/Claude Desktop)

1. Clone this repository:

git clone https://github.com/klogins-hash/terminal-ssh-mcp.git
cd terminal-ssh-mcp

2. Install dependencies and build:

npm install
npm run build

3. Add to your MCP configuration:

For Cline (VS Code): Edit ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:

{
  "mcpServers": {
    "terminal-ssh": {
      "command": "node",
      "args": ["/path/to/terminal-ssh-mcp/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

For Claude Desktop: Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "terminal-ssh": {
      "command": "node",
      "args": ["/path/to/terminal-ssh-mcp/build/index.js"]
    }
  }
}

Railway Deployment

This server can be deployed to Railway for cloud-based access:

1. Create a new Railway project
2. Deploy from this GitHub repository
3. Railway will automatically:
   • Install dependencies
   • Build the TypeScript
   • Deploy the MCP server

The server will run on Railway and can be accessed via SSH through Railway's CLI.

Available Tools

execute_command

Run shell commands locally and capture output.

Parameters:

• command (required): The shell command to execute
• cwd (optional): Current working directory
• timeout (optional): Timeout in milliseconds (default: 30000)

railway_ssh

SSH into a Railway service container.

Parameters:

• project (required): Railway project ID
• environment (required): Railway environment ID
• service (required): Railway service ID
• command (optional): Command to run in the container (if not provided, returns SSH command)

read_file

Read file contents.

Parameters:

• path (required): Path to the file

write_file

Write content to a file.

Parameters:

• path (required): Path to the file
• content (required): Content to write

list_directory

List files and directories in a path.

Parameters:

• path (required): Directory path to list

Development

Building

npm run build

Testing

npm run start

Development Mode

npm run dev

Architecture

• Framework: MCP SDK (Model Context Protocol)
• Language: TypeScript
• Runtime: Node.js 22+
• Transport: Stdio-based communication

Security Considerations

• API credentials should not be committed to repositories
• Use environment variables for sensitive configuration
• SSH keys are managed by Railway CLI
• All commands execute with current user permissions

License

MIT

Support

For issues and questions, please open an issue on GitHub.