Context7 MCP 服务器 (c7-mcp-server)

<!-- Add npm version badge once published: -->

一个 模型上下文协议 (MCP) 服务器，充当 Context7 API 的桥梁。

此服务器允许 MCP 兼容的客户端（如 Claude Desktop、IDE 插件、自定义应用程序）轻松与 Context7 的功能交互，包括查询文档上下文、搜索项目和检索项目元数据。 它在全局安装后公开 c7-mcp-server 命令。

⚠️ 重要提示： 通过此服务器提供的所有数据均直接来自官方 Context7 API (https://context7.com)。 此服务器仅提供该 API 的 MCP 接口，不生成或托管任何内容本身。

功能

通过标准 MCP 功能公开 Context7 功能：

• 工具：
  • c7_query：查询 Context7 API 以获取项目中特定主题的信息。 接受项目名称、查询文本、可选格式（txt/json）和可选令牌限制。
  • c7_search：按关键字搜索可用的 Context7 项目。 返回匹配的项目列表（标题和可用名称）。
  • c7_info：获取有关特定 Context7 项目的元数据（如源存储库、上次更新等）。
• 资源：
  • c7_projects_list：通过 URI context7://projects/list 提供所有可用（有效）Context7 项目的列表。

安装

前提条件

• Node.js（建议使用 18+ 版本）
• npm（通常随 Node.js 一起提供）或 Bun

选项 1：从 npm 安装（推荐给用户）

发布后，全局安装服务器：

npm install -g c7-mcp-server

这将使 c7-mcp-server 命令在系统范围内可用，从而允许 MCP 客户端启动它。

选项 2：从源代码安装（用于开发）

1. 克隆存储库：

   git clone <your-repo-url>
   cd c7-mcp-server
   

2. 安装依赖项：

   npm install
   # or if using Bun
   # bun install
   

3. 构建服务器：

   npm run build
   

4. 在本地链接命令：

   npm link
   # or if using Bun
   # bun link
   

这将使 c7-mcp-server 命令在您的本地计算机上可用，以进行测试和开发。

用法

此服务器旨在由 MCP 客户端应用程序运行，通常不由最终用户直接运行（除了测试）。 客户端启动 c7-mcp-server 命令，它们使用 MCP 协议通过标准输入/输出 (stdio) 进行通信。

使用客户端配置（示例：Claude Desktop）

要将此服务器与 Claude Desktop 等客户端一起使用，您需要将其添加到客户端的配置文件中。

1. 确保 c7-mcp-server 已全局安装 (npm install -g c7-mcp-server) 或在本地链接 (npm link)。

2. 编辑客户端的配置文件（例如，claude_desktop_config.json）：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. 在 mcpServers 下添加一个条目：

   {
     "mcpServers": {
       "context7": {
         "command": "c7-mcp-server", // 安装/链接的命令名称
         "args": [] // 默认情况下，stdio 传输不需要参数
         // "env": {} // 如果需要，添加环境变量
       }
       // ... 其他服务器 ...
     }
   }
   

4. 重新启动客户端应用程序（例如，Claude Desktop）。 客户端现在将在后台启动 c7-mcp-server 并连接到它。

使用 MCP Inspector 进行测试

您可以使用 MCP Inspector 直接测试服务器：

1. 确保 c7-mcp-server 已全局安装或在本地链接。

2. 运行 Inspector，告诉它执行您的服务器命令：

   npx @modelcontextprotocol/inspector c7-mcp-server
   

3. Inspector UI 将在您的浏览器中打开，并连接到您的服务器。 使用“工具”和“资源”选项卡与服务器的功能进行交互。 检查“通知”窗格以获取来自服务器的日志/错误。

MCP 功能详情

工具

• c7_query

  • 描述： 查询 Context7 API 以获取项目中特定主题的信息。
  • 参数 (object)：
    • projectname (string, required)：确切的项目名称（例如，nextjs）。
    • query (string, required)：要查询的主题/问题。
    • format (enum: "txt" | "json", optional, default: "txt")：输出格式。
    • tokens (number, optional)：响应的最大令牌数。
  • 返回： 包含来自 Context7 的结果的文本内容（纯文本或 JSON 字符串）。

• c7_search

  • 描述： 按关键字搜索可用的 Context7 项目。
  • 参数 (object)：
    • term (string, required)：要在项目标题中搜索的关键字。
  • 返回： 包含匹配项目的 JSON 字符串数组的文本内容，每个项目都包含 title 和 name（可用的项目名称）。

• c7_info

  • 描述： 显示有关特定 Context7 项目的元数据。
  • 参数 (object)：
    • projectname (string, required)：确切的项目名称。
  • 返回： 包含项目完整元数据的 JSON 字符串表示形式的文本内容。

资源

• c7_projects_list
  • URI： context7://projects/list
  • 描述： 提供所有可用且有效的 Context7 项目的列表。
  • 返回： 具有 mimeType: "application/json" 的内容，其中包含项目对象的 JSON 字符串数组。

开发

1. 克隆存储库。
2. 安装依赖项 (npm install 或 bun install)。
3. 构建服务器 (npm run build)。 在开发期间使用 npm run dev 进行自动重建和启动。
4. 链接以进行本地测试 (npm link 或 bun link)。
5. 使用 MCP Inspector 进行测试 (npx @modelcontextprotocol/inspector c7-mcp-server)。
6. 在 src/ 目录中进行更改并重建。

许可证

MIT