Agent-Skill-Kit MCP Gateway

关键词

Model Context ProtocolAI agent toolslocal skill gatewayskill discoveryJSON-RPC

使用说明（Markdown格式）

  1. 项目简介
  • 该仓库包含一个名为 MCP Gateway 的服务器实现文件 core/mcp_gateway.py，核心目标是把 Agent-Skill-Kit 中的本地技能（skills/ 下的各个技能）通过 MCP（Model Context Protocol）暴露为可被 MCP 客户端发现并执行的工具。
  • 服务器通过 JSON-RPC 的方式与客户端进行通信，支持列出可用工具、调用工具以及返回文本输出等能力。适用于让 Claude Code、Copilot 等 AI 代理直接发现并执行本地技能。
  1. 主要功能点
  • 将本地技能作为 MCP 工具暴露给客户端，技能信息来自每个技能目录中的 manifest.yaml。
  • 支持动态发现与加载技能，自动构建工具定义（名称、描述、输入参数等）。
  • 支持通过 JSON-RPC 调用工具，执行技能脚本（script.py），并把执行结果以文本形式返回。
  • 基于 asyncio 的异步服务器，具备非阻塞、可扩展的特性。
  • 在缺少依赖时给出安装提示，指明需要安装的包（如 mcp、pyyaml 等）。
  1. 安装步骤
  • 安装依赖（最低要求的依赖在代码中有内容提示）：
    • pip install mcp pyyaml
    • pip install PyYAML
    • 以及 leftovers 依赖（如果未安装请根据报错安装，如 rich 等）
  • 你也可使用仓库根目录中的依赖文件安装：
    • pip install -r requirements.txt
  • 运行 MCP 服务器前，请确保你已具备运行 Python 环境以及网络访问权限以探索本地技能。
  1. 服务器配置（MCP 客户端启动与连接信息） 以下配置用于 MCP 客户端了解如何启动与连接该 MCP 服务器。请注意，这只是用于描述连接信息的示例，实际连接需在你的 MCP 客户端配置中使用相应字段。

示例配置（JSON）： { "server_name": "Agent-Skill-Kit MCP Gateway", "command": "python", "args": ["core/mcp_gateway.py"] }

字段说明：

  • server_name: MCP 服务器对外标识的名称，便于客户端在工具列表中展示和选择。
  • command: 启动服务器所使用的命令（此处为 Python 解释器，执行核心 gateway 脚本）。
  • args: 启动命令的参数列表，指向本仓库中的 core/mcp_gateway.py，启动后服务器将自动加载 skills 目录中的 manifest.yaml 并暴露工具。
  1. 基本使用方法
  • 启动服务器：在仓库根目录执行命令 python core/mcp_gateway.py
  • 客户端交互：Claude Code、Copilot 等通过 MCP 协议向服务器发起 JSON-RPC 请求，调用列出工具、调用具体工具等操作，获取文本输出。
  • 典型流程（简述，非代码）：
    • 客户端请求列出可用工具，服务器返回工具清单。
    • 客户端调用某个工具，并传入所需参数，服务器执行对应 skill 的 script.py，并将输出返回给客户端。
    • 客户端可对输出进行解析、摘要或进一步处理。
  • 需要注意：若未安装依赖，服务器在启动时会提示安装指引并退出，请先安装所需依赖后再重试。

服务器信息

访问项目