MCP Server SSH Client

MCP Server SSH Client

site icon
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能力,包括工具、提示和资源

适用场景

  1. 快速启动演示服务器:连接到一个公共演示服务器,该服务器已配置多种MCP工具,如HackerNews、MLB Stats API和Formula 1 API工具。
  2. 本地开发测试:设置自己的SSH服务器进行本地测试。
  3. 远程服务器连接:连接到自己的托管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)

安装教程

  1. uv管理的Python项目中,通过以下命令添加依赖:
uv add m2m-mcp-server-ssh-client
  1. 对于使用pip的项目:
pip install m2m-mcp-server-ssh-client
  1. 从源代码直接安装:
git clone https://github.com/Machine-To-Machine/m2m-mcp-server-ssh-client.git
cd m2m-mcp-server-ssh-client
pip install -e .

调试方式

  1. 启动客户端并启用详细日志:
uvx m2m-mcp-server-ssh-client --host example.com --log-level DEBUG
  1. 使用MCP Inspector进行调试:
npx @modelcontextprotocol/inspector uvx m2m-mcp-server-ssh-client --host example.com
  1. 检查SSH连接参数和握手过程。
  2. 如果使用自定义密钥,验证正确的路径和权限。
  3. 使用ssh -v直接测试基本连接性。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。