{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_auaxmjbn8566","handle":"ssh-mcp-py","url":"https://wellknown.network/agents/ssh-mcp-py","links":{"self":"https://wellknown.network/agents/ssh-mcp-py/record.json","html":"https://wellknown.network/agents/ssh-mcp-py","markdown":"https://wellknown.network/agents/ssh-mcp-py/record.md","api":"https://wellknown.network/api/v1/agents/ssh-mcp-py","status":"https://wellknown.network/api/v1/agents/ssh-mcp-py/status","claim":"https://wellknown.network/agents/ssh-mcp-py/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/ssh-mcp-py/claim.json","badge":"https://wellknown.network/agents/ssh-mcp-py/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/ssh-mcp-py/history","tools":"https://wellknown.network/api/v1/agents/ssh-mcp-py/tools"},"ard":{"identifier":"urn:air::server:ssh-mcp-py","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"ssh-mcp-py","summary":"A Model Context Protocol for managing and interacting with multiple virtual machines over SSH","description":"# SSH MCP: Model Context Protocol tool for Virtual Machine Management over SSH\n\nSSH MCP is a Model Context Protocol tool written in Python for managing and interacting with multiple virtual machines (VMs) over SSH. It simplifies executing commands on remote servers by using the standard SSH config file format and leverages the robust `paramiko` library to handle SSH connections and command execution securely and efficiently.\n\n-----\n\n## Usage Guide 📖\n\nSSH MCP can be used in two ways: as an MCP server or as a direct command-line tool.\n\n### MCP Server Usage\n\nSSH MCP can also run as an MCP server, providing tools that can be used by AI assistants and other MCP clients:\n\n```bash\nuv run ssh-mcp-py\n```\n\n**Available MCP Tools:**\n\n1. **execute_ssh_command**: Execute a command on a remote host\n   - Parameters: `hostname` (string), `command` (string)\n\n2. **list_ssh_hosts**: List all configured SSH hosts\n   - Parameters: None\n\n3. **get_host_info**: Get detailed information about a specific host\n   - Parameters: `hostname` (string)\n\n4. **test_ssh_connection**: Test SSH connection to a host\n   - Parameters: `hostname` (string)\n\n### Integration with Claude Desktop\n\nTo use SSH MCP with Claude Desktop, add the following configuration to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"ssh\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"ssh-mcp-py\"\n      ],\n      \"env\": {\n        \"MCP_TRANSPORT\": \"stdio\",\n        \"SSH_CONFIG_PATH\": \"/Users/your_username/.ssh/config\"\n      }\n    }\n  }\n}\n```\n\n**Configuration File Location:**\n\n- **macOS**: `/Users/your_username/Library/Application Support/Claude/claude_desktop_config.json`\n\nReplace `your_username` with your actual username\n\n### Direct Command-Line Usage\n\nYou can execute commands directly using the command line interface:\n\n**Basic Command Execution**:\n\n```bash\nuv run cli.py <host> \"<command_to_execute>\"\n```\n\n**Examples**:\n\nTo list the files in the home directory of `web-server-01`:\n\n```bash\nuv run cli.py web-se…","publisher":null,"homepage":"https://github.com/sondt2709/ssh-mcp-py","repository":"https://github.com/sondt2709/ssh-mcp-py","version":"0.1.3","license":"MIT","protocols":["mcp"],"tags":["vm","mcp","llm","automation"],"pricing":null,"endpoints":[{"url":"pypi:ssh-mcp-py","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.825,"provenance":"derived"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"ssh-mcp-py","registry":"pypi","observedAt":"2026-11-04T01:24:53.207Z","publishedAt":"2026-06-04T15:16:00.048570Z","latestVersion":"0.1.3"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"ssh-mcp-py","url":"https://pypi.org/project/ssh-mcp-py/","firstSeenAt":"2026-09-10T13:19:26.829Z","fetchedAt":"2026-11-04T01:23:33.806Z","normalizedAt":"2026-11-04T01:23:33.806Z"}]},"firstSeenAt":"2026-09-10T13:19:26.829Z","updatedAt":"2026-11-04T01:24:53.207Z"}