SSH Agent MCP VS Code Extension

Remote administration and SSH management via Model Context Protocol (MCP) for VS Code.

Installation (Marketplace or VSIX)

Marketplace: Install "SSH Agent MCP" (Publisher: Intelligent Plant)
VSIX: Use the packaged ssh-agent-mcp-*.vsix if installing manually

Setup (hands-free)

Python: Ensure Python 3.9+ is on PATH and the server package is installed:

pip install ssh-agent-mcp

or from source:

pip install -e .

Auto-register & auto-key: On first activation, the extension:

Writes/updates your VS Code mcp.json (user profile) with the MCP server entry
Auto-generates AGENT_MCP_KEY if missing (no manual key needed)
Uses IntelligentPlant/ssh-agent-mcp as the server key

The entry it writes (values may be auto-detected):

{
  "servers": {
    "IntelligentPlant/ssh-agent-mcp": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "ssh_agent_mcp.server"],
      "env": {
        "AGENT_MCP_KEY": "<auto-generated>"
      },
      "gallery": "https://api.mcp.github.com",
      "version": "0.1.1"
    }
  }
}

Features

15 Remote Admin Tools: run_command, upload_file, download_file, add_note, test_connection, and more
Connection Management: Add, update, remove, and test SSH connections
File Transfer: Upload and download files to/from remote hosts
Host Key Pinning: Securely pin and verify host keys across sessions
Encrypted Storage: All credentials are AES-encrypted and stored locally
Command Logging: Track command history and execution status

Usage

After installation, restart VS Code; the server will appear in the MCP server list (@mcp / Configure Tools). Then:

Select "SSH Agent MCP" from the server dropdown
Call tools like run_command, upload_file, add_note to manage remote systems

Security

Encryption Key: Auto-generated on first activation; stored in mcp.json
Host Keys: Stored in %APPDATA%/Code/User/mcp_known_hosts (pinned after first connection)
Credentials: Encrypted using your key before storage in the local database
No Hardcoded Secrets: All credentials are externalized via configuration

Troubleshooting

"Missing AGENT_MCP_KEY": Re-activate the extension; it will auto-generate and write it
Python not found: Ensure Python 3.9+ is installed and in your PATH
Host key not trusted: First connection requires verification; use MCP_KNOWN_HOSTS env to override storage location
Check logs: Run the server directly to see detailed error messages:
```
python -m ssh_agent_mcp.server
```

Development

cd vscode-extension
npm install
npm run compile

License

See license.txt.

SSH Agent MCP

Intelligent Plant