claude-mcp-tools

关键词

SSH远程命令执行文件传输端口转发PTY

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库实现了一组基于 MCP（Model Context Protocol）的服务器端工具集合，核心在于提供后端服务器来托管 Resources、Tools、Prompts，并通过 JSON-RPC 与客户端通信，适用于 LLM 进行上下文信息获取与功能调用。服务器侧具备会话管理、能力声明，以及对多种传输协议的支持（如 Stdio、SSE、WebSocket）。

  • 主要功能点

    • MCP 服务器骨架与核心能力
      • 使用 MCP 标准注册并暴露“工具（Tools）”、“资源（Resources）”等能力，提供统一的 JSON-RPC 接口。
      • 会话管理、能力声明、以及跨传输协议的适配能力。
    • SSH 相关工具集（mcp-ssh）
      • SSH 连接管理、命令执行、文件操作、SFTP、目录同步、端口转发、PTY 会话等完整实现。
      • 支持跳板机、会话持久化、以及多种认证方式（密码、密钥、代理等）。
    • 浏览器/网页相关工具集（mcp-chrome 及其服务器入口）
      • 提供浏览器自动化能力的工具集合，涵盖文本提取、网页交互、等待、截图、Cookies、网络日志等，具扩展模式与 CDP 模式并存的能力。
    • 工具注册与入口
      • 服务器端通过 MCP SDK 提供的 McpServer 来注册不同的工具集（如 connection、exec、file、pty、forward 等）。
    • 配置与部署
      • 服务器入口脚本与工具模块化组织，支持通过 dist/index.js 启动 MCP 服务器并与客户端协作。
    • 会话与资源的管理
      • 提供会话池、日志、网络请求、资源获取等能力，确保 LLM client 在运行时能稳定访问所需上下文。

  • 安装步骤（简要）

    • 确保环境具备 Node.js 运行环境。
    • 克隆仓库后，安装依赖（如 npm install 或 yarn install）。
    • 编译/构建各子模块源码（参考各子目录的 README，通常会输出 dist 目录）。
    • 启动 MCP 服务器入口（示例：node dist/index.js）。服务器启动后会监听 MCP 客户端的连接请求。
    • 如需对接 MCP 客户端，请按照客户端配置要求提供服务器地址、命令与参数等信息。

  • 服务器配置（给 MCP 客户端使用的 JSON 配置示例，已根据仓库信息生成并注释） 说明：以下信息用于 MCP 客户端建立与服务器的连接。客户端本身不需要包含敏感信息；配置仅用于描述如何启动与连接服务器。 { "name": "claude-mcp-tools", "description": "Claude Code MCP 工具服务器 - 提供 SSH、浏览器自动化等工具的 MCP 服务", "command": "node", "args": ["dist/index.js"], "notes": "dist/index.js 为服务器入口，启动后将暴露 MCP 的工具集，供客户端通过 JSON-RPC 调用。若使用子模块入口，请按实际部署路径调整参数。" }

  • 基本使用方法

    1. 启动服务
      • 在服务器上运行上述命令启动 MCP 服务器入口。
    2. 客户端连接
      • 使用 MCP 客户端（如同仓库示例中的测试客户端）通过服务器的启动命令与参数建立连接。
    3. 调用工具
      • 使用 MCP 客户端向服务器发起工具调用，服务器根据注册的 Tools 提供相应的执行结果与上下文信息。
    4. 资源与会话管理
      • 通过服务器提供的工具，LLM 客户端可读取/写入资源、执行命令、进行文件操作、管理会话等，获得统一的响应格式。
    5. 部署与扩展
      • 可以在服务端继续扩展新的 Tools、Resources 与 Prompts，服务器会通过 MCP 的注册机制暴露给客户端。

  • 备注

    • 本仓库包含了多种工具实现（SSH、Chrome 自动化等），并提供对应的服务端入口与工具注册逻辑，理论上即可作为一个可运行的 MCP 服务器实现。实际部署时请确保构建产物（dist 目录）与入口路径符合你的运行环境。

关键词 SSH, 远程命令执行, 文件传输, 端口转发, PTY

分类ID 1

服务器信息

访问项目