{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_nrvuw37ba2m2","handle":"mcp-ssh-server","url":"https://wellknown.network/agents/mcp-ssh-server","links":{"self":"https://wellknown.network/agents/mcp-ssh-server/record.json","html":"https://wellknown.network/agents/mcp-ssh-server","markdown":"https://wellknown.network/agents/mcp-ssh-server/record.md","api":"https://wellknown.network/api/v1/agents/mcp-ssh-server","status":"https://wellknown.network/api/v1/agents/mcp-ssh-server/status","claim":"https://wellknown.network/agents/mcp-ssh-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-ssh-server/claim.json","badge":"https://wellknown.network/agents/mcp-ssh-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-ssh-server/history","tools":"https://wellknown.network/api/v1/agents/mcp-ssh-server/tools"},"ard":{"identifier":"urn:air::server:mcp-ssh-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-ssh-server","summary":"SSH MCP Server - 基于 Model Context Protocol 的 SSH 连接管理和命令执行服务器","description":"# SSH MCP Server\n\n一个基于 Model Context Protocol (MCP) 的 SSH 服务器，提供通过 SSH 连接到远程服务器并执行命令的功能。\n\n## 功能特性\n\n- 🔐 支持密码和SSH密钥认证\n- 🌐 **支持多个命名SSH连接**\n- 🚀 执行远程shell命令\n- 📊 获取命令执行结果（成功/失败状态、退出码）\n- 📝 获取命令输出内容（stdout、stderr）\n- 🔄 支持交互式命令执行\n- 📤 支持文件上传（SFTP）\n- ⚡ 基于环境变量的灵活配置\n- 🛡️ 完善的错误处理和日志记录\n- ♻️ 向后兼容传统单连接配置\n\n## 快速开始\n\n### 方式一：使用 uvx（推荐，无需克隆）\n\n直接在 MCP 客户端配置中使用 `uvx`，无需手动安装：\n\n#### Claude Desktop\n\n编辑配置文件（Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`，macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`）：\n\n```json\n{\n  \"mcpServers\": {\n    \"ssh\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-ssh-server\"],\n      \"env\": {\n        \"SSH_PROD_HOST\": \"your-server.com\",\n        \"SSH_PROD_USERNAME\": \"admin\",\n        \"SSH_PROD_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n#### VS Code / Cursor\n\n在项目根目录创建 `.mcp.json` 文件：\n\n```json\n{\n  \"mcpServers\": {\n    \"ssh\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-ssh-server\"],\n      \"env\": {\n        \"SSH_PROD_HOST\": \"your-server.com\",\n        \"SSH_PROD_USERNAME\": \"admin\",\n        \"SSH_PROD_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n### 方式二：从源码安装\n\n```bash\n# 克隆仓库\ngit clone https://github.com/liang04/ssh-mcp.git\ncd ssh-mcp\n\n# 使用 uv 安装\npip install uv\nuv sync\n\n# 或使用 pip 安装\npip install -e .\n```\n\n配置 MCP 客户端使用本地安装：\n\n```json\n{\n  \"mcpServers\": {\n    \"ssh\": {\n      \"command\": \"uv\",\n      \"args\": [\"--directory\", \"/path/to/ssh-mcp\", \"run\", \"mcp-ssh-server\"],\n      \"env\": {\n        \"SSH_PROD_HOST\": \"your-server.com\",\n        \"SSH_PROD_USERNAME\": \"admin\",\n        \"SSH_PROD_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n> **提示**：将 SSH 连接信息替换为您的实际配置。支持通过环境变量配置多个连接，详见下方配置说明。\n\n## 配置\n\n### 多连接配置（推荐）\n\n通过环境变量配置多个命名SSH连接，格式为 `SSH_{连接名}_{参数名}`：\n\n```bash\n# 生产环境连接\nSSH_PROD_HOST=prod.example.com\nSSH_PROD_USERNAME=admin\nSSH_PROD_PASSWORD=prod_password\nSSH_PROD_PORT=22\n\n# 测试环境连接\nSSH_TEST_HOST=test.example.com\nSSH_TEST_USERNAME=tester\nSSH_TEST_KEY_PATH=/path/to/test_key\nSSH_TEST_PORT=2222\n\n# 开发环境连接\nSSH_DEV_HOST=dev.example.com\nSSH_DEV_U…","publisher":null,"homepage":"https://github.com/liang04/ssh-mcp","repository":"https://github.com/liang04/ssh-mcp","version":"0.1.4","license":"MIT","protocols":["mcp"],"tags":["command","mcp","model-context-protocol","remote","sftp","ssh"],"pricing":null,"endpoints":[{"url":"pypi:mcp-ssh-server","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.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"fr"},"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":"mcp-ssh-server","registry":"pypi","observedAt":"2026-10-28T14:24:38.362Z","publishedAt":"2026-01-19T01:53:28.327598Z","latestVersion":"0.1.4"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-ssh-server","url":"https://pypi.org/project/mcp-ssh-server/","firstSeenAt":"2026-09-10T04:23:19.314Z","fetchedAt":"2026-10-28T14:23:14.022Z","normalizedAt":"2026-10-28T14:23:14.022Z"}]},"firstSeenAt":"2026-09-10T04:23:19.314Z","updatedAt":"2026-10-28T14:24:38.362Z"}