Context7 MCP Server (

Context7 MCP 服务（c7-mcp-server）

一个 Model Context Protocol（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）和可选 token 限制。
  • 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": {} // 如有需要，可添加环境变量
       }
       // ... other servers ...
     }
   }
   

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

使用 MCP Inspector 进行测试

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

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

2. 运行 Inspector，并指定要执行的服务命令：

   npx @modelcontextprotocol/inspector c7-mcp-server
   

3. Inspector 界面将在浏览器中打开，并连接到你的服务。使用“Tools”和“Resources”选项卡与服务功能交互。查看“Notifications”面板中的服务日志和错误。

MCP 功能详情

工具

• c7_query

  • Description： 查询 Context7 API，获取项目中特定主题的信息。
  • Parameters (object)：
    • projectname（string，必填）：确切的项目名称（例如，nextjs）。
    • query（string，必填）：要查询的主题或问题。
    • format（enum："txt" | "json"，可选，默认值："txt"）：输出格式。
    • tokens（number，可选）：响应的最大 token 数。
  • **Returns：**包含 Context7 查询结果的文本内容（纯文本或 JSON 字符串）。

• c7_search

  • **Description：**按关键词搜索可用的 Context7 项目。
  • Parameters (object)：
    • term（string，必填）：用于搜索项目标题的关键词。
  • **Returns：**包含匹配项目 JSON 字符串数组的文本内容，每个项目都包含 title 和 name（可用的项目名称）。

• c7_info

  • **Description：**显示特定 Context7 项目的元数据。
  • Parameters (object)：
    • projectname（string，必填）：确切的项目名称。
  • **Returns：**包含项目完整元数据 JSON 字符串表示形式的文本内容。

资源

• c7_projects_list
  • URI： context7://projects/list
  • **Description：**提供所有可用且有效的 Context7 项目列表。
  • **Returns：**内容包含 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