研究能力包 MCP 服务器

使用说明

• 项目简介

  • 该仓库实现了一个完整的 MCP 服务器，遵循 Model Context Protocol（MCP）规范，通过 JSON-RPC 的方式与客户端通信，提供对资源、工具与 Prompts 的托管、注册、执行与渲染能力。服务器支持多传输模式（STDIO、HTTP 流式、云端 Workers），并具备健壮的错误处理以避免崩溃。

• 主要功能点

  • MCP 核心能力
    • 资源/数据访问与管理（Resources/Prompts 的托管与渲染）
    • 工具注册与执行（Tools），支持多种外部功能调用
    • Prompt 模板与渲染（Prompts），支持可定制的交互模式
  • 多传输模式
    • STDIO：适用于 Claude Desktop、Cursor、Windsurf 等本地客户端
    • HTTP Streamable：自托管/局域网共享
    • Cloudflare Workers：全球分布的无服务器端点
  • 安全与稳定性
    • 全局错误处理与日志记录，保证工具失败不致服务器崩溃
    • 会话管理与能力声明，按环境动态开启/禁用工具
  • 工具生态
    • 内置工具包括 web_search、search_reddit、get_reddit_post、scrape_links、deep_research 等，按 ENV 配置自动开启
  • YAML 配置与工具注册
    • 支持从 YAML 生成 MCP 工具描述，实现“单一来源的工具元数据”与运行时动态架构

• 安装与运行

  • 安装依赖、构建与运行的典型流程（参考仓库自述）
  • 运行模式示例：
    • STDIO 模式（默认）：直接启动 MCP 服务器，客户端通过 STDIO 连接
    • HTTP 模式：设置 MCP_TRANSPORT=http 后以 HTTP 流式传输，与客户端建立会话
  • 注意事项
    • 需要根据实际环境提供相应的 API Key/Client Credentials，以激活相应的工具集
    • 错误处理和日志会尽可能返回结构化信息，帮助快速定位问题

• 服务器配置（MCP 客户端所需信息，非代码，按配置描述） 配置用于告诉 MCP 客户端如何连接本 MCP 服务器。说明如下：

  • server_name：research-powerpack
  • command：npx
  • args：mcp-researchpowerpack 该配置表示客户端应通过执行 npx mcp-researchpowerpack 启动服务器实例，并以默认 STDIO 或按需要切换到其他传输模式。更多环境变量（如 SERPER_API_KEY、REDDIT_CLIENT_ID 等）用于开启相应工具，请在实际环境中设置。

  服务器配置注记（仅描述用，不是可执行代码）：

  • server_name: "research-powerpack"
  • command: "npx"
  • args: ["mcp-researchpowerpack"]
  • 说明：以上信息用于 MCP 客户端端连接时的基础定位，实际环境还需设置工具所需的 API Key/凭证等环境变量，以开启相应工具。