Goodfoot MCP 服务器集合

使用说明

  • 项目简介 本仓库是一个面向开发者的基金式工作流资源集合,包含基于 MCP 的服务器实现,以及用于 Claude Code 等场景的插件市场和工具。核心目标是通过标准化的 MCP 服务为 LLM 客户端提供资源访问、工具调用与提示模板渲染能力,并支持多种传输协议的 JSON-RPC 交互。

  • 主要功能点

    • 资源与数据访问:服务器提供可读取/查询的资源集合,供 LLM 客户端在对话中获取上下文信息。
    • 工具注册与执行:可向 LLM 客户端暴露外部功能(Tools),LLM 可通过工具调用实现外部能力。
    • Prompt 模板定义与渲染:提供可定制化的 Prompt 模板,支持不同的交互模式。
    • 多传输协议支持:支持标准输入输出(stdio)、Server-Sent Events(SSE)和基于 HTTP 的流式传输,且通过 JSON-RPC 进行请求/响应。
    • 会话与能力声明:服务器端维护会话状态、能力声明,并可扩展到不同传输通道。
    • Monorepo 结构化管理:为 MCP 服务器提供独立包、示例实现及示例服务器,便于本地开发与测试。
  • 安装步骤

    1. 获取代码:克隆仓库到本地或在本地开发环境中打开该工作区。
    2. 安装依赖:在仓库根目录执行包管理工具安装(如 yarn 或 npm),并安装所有工作区依赖。
    3. 构建 MCP 服务器包:分别在 packages/ 目录下的 MCP 服务器实现中执行构建命令,例如对 models/、streamable-http-mcp-server-daemon/ 等包执行构建。
    4. 运行服务器示例:
      • 以 stdio 传输为例,运行某个 MCP 服务器包的启动命令,例如 node 构建产物的入口脚本;
      • 以 HTTP/SSE 传输为例,启动对应的 HTTP 服务或 SSE 服务入口。
    5. 在 Claude Code 等客户端中按客户端配置加载这些 MCP 服务器,以便插件和工具可被 LLM 客户端发现和使用。
  • 服务器配置(MCP 客户端配置客户端无需关心,以下信息用于 MCP 客户端/部署方设定) 提示:以下配置示例为 JSON 形式,描述服务器的名称、传输方式、启动命令及参数等。请将其作为参考在你的部署脚本或运行环境中配置,实际客户端使用时无需贴出代码。

    • 服务器 1(模型服务,stdio) { "serverName": "models", "transport": "stdio", "command": "node", "args": ["packages/models/build/index.js"], "env": {} }
    • 服务器 2(示例 HTTP 服务,http) { "serverName": "example-http", "transport": "http", "url": "http://127.0.0.1:47127/mcp", "headers": { "Authorization": "Bearer <token>" }, "env": {} }
    • 服务器 3(示例 SSE 服务,sse) { "serverName": "example-sse", "transport": "sse", "url": "https://example.com/mcp", "headers": { "Authorization": "Bearer <token>" }, "env": {} }
  • 基本使用方法

    • 启动 MCP 服务器:按各服务器实现的说明启动对应的命令,确保监听端口可达且与客户端配置一致。
    • 客户端连接:在 Claude Code/其他 MCP 客户端中,将上述服务器配置加载到客户端,客户端即可发现 Resources、Tools 与 Prompts,并通过 JSON-RPC 调用完成资源读取、工具执行与提示渲染。
    • 会话与安全:服务器负责会话管理与能力声明,支持多传输协议,确保上下文服务在各种应用场景中的安全性与扩展性。

服务器信息