
MCP Server SSH Client

2025.05.09
0
PythonSSH客户端远程连接工具其它
MCP Server SSH Client 是一个通过SSH连接到远程MCP服务器的客户端工具,它提供了一个安全的通道来访问和使用远程服务器上的MCP工具。该客户端支持基于密钥的认证,能够代理所有MCP协议命令,适用于多种使用场景,包括快速启动演示服务器、本地开发测试以及远程服务器连接。
View on GitHub
Overview
基本能力
产品定位
MCP Server SSH Client 是一个通过SSH连接到远程MCP服务器的客户端工具,旨在提供一个安全的通道来访问和使用远程服务器上的MCP工具。
核心功能
- 通过SSH连接到任何MCP服务器
- 通过安全的SSH通道代理所有MCP协议命令
- 支持基于密钥的认证
- 支持MCP能力,包括工具、提示和资源
适用场景
- 快速启动演示服务器:连接到一个公共演示服务器,该服务器已配置多种MCP工具,如HackerNews、MLB Stats API和Formula 1 API工具。
- 本地开发测试:设置自己的SSH服务器进行本地测试。
- 远程服务器连接:连接到自己的托管MCP服务器。
工具列表
- MCP Inspector:用于调试或探索可用工具。
常见问题解答
- 连接被拒绝:验证主机和端口是否正确,以及SSH服务是否正在运行。
- 认证失败:检查密钥文件路径,确保远程服务器已安装您的公钥。
- 主机密钥验证失败:将主机密钥添加到known_hosts文件,或使用
--disable-host-key-checking
(仅用于测试)。
使用教程
使用依赖
确保已安装以下依赖: - anyio (>=4.5.0) - asyncssh (>=2.20.0) - mcp (>=1.1.3) - pydantic (>=2.0.0)
安装教程
- 在
uv
管理的Python项目中,通过以下命令添加依赖:
uv add m2m-mcp-server-ssh-client
- 对于使用
pip
的项目:
pip install m2m-mcp-server-ssh-client
- 从源代码直接安装:
git clone https://github.com/Machine-To-Machine/m2m-mcp-server-ssh-client.git
cd m2m-mcp-server-ssh-client
pip install -e .
调试方式
- 启动客户端并启用详细日志:
uvx m2m-mcp-server-ssh-client --host example.com --log-level DEBUG
- 使用MCP Inspector进行调试:
npx @modelcontextprotocol/inspector uvx m2m-mcp-server-ssh-client --host example.com
- 检查SSH连接参数和握手过程。
- 如果使用自定义密钥,验证正确的路径和权限。
- 使用
ssh -v
直接测试基本连接性。