AI导哈

Context7 MCP 服务器

一个作为Context7 API桥梁的Model Context Protocol (MCP)服务器，允许MCP兼容客户端查询文档上下文、搜索项目和检索项目元数据。

  • by quiint
  • JavaScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 quiint/c7-mcp-server

使用说明

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

A. 模型上下文协议（MCP） 充当到 上下文7 API.

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

⚠️ 重要提示： 通过此服务器提供的所有数据都直接来自官方 上下文7 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项目的列表 context7://projects/list.

安装

先决条件

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

选项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
    • 窗户： %APPDATA%\Claude\claude_desktop_config.json

  3. 在下面添加条目 mcpServers:

    {
  "mcpServers": {
    "context7": {
      "command": "c7-mcp-server", // The command name installed/linked
      "args": [] // No arguments needed by default for stdio transport
      // "env": {} // Add environment variables if needed
    }
    // ... other servers ...
  }
}

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

MCP检验员测试

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

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

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

    npx @modelcontextprotocol/inspector c7-mcp-server

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

MCP功能详细信息

工具

  • c7_query

    • 说明： 查询Context7 API以获取有关项目中特定主题的信息。
    • 参数(object):
      • projectname （string，必填）：确切的项目名称（例如。， nextjs).
      • query （字符串，必填）：要查询的主题/问题。
      • format （枚举： "txt" | "json"，可选，默认值： "txt")：输出格式。
      • tokens （number，可选）：响应的最大令牌数。
    • 退货： 包含Context7结果的文本内容（纯文本或JSON字符串）。

  • c7_search

    • 说明： 按关键字搜索可用的Context7项目。
    • 参数(object):
      • term （string，必填）：在项目标题中搜索的关键字。
    • 退货： 文本内容包含匹配项目的JSON字符串数组，每个项目都有 title 和 name （可用的项目名称）。

  • c7_info

    • 说明： 显示特定Context7项目的元数据。
    • 参数(object):
      • projectname （string，必填）：确切的项目名称。
    • 退货： 包含项目完整元数据的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检查员 (npx @modelcontextprotocol/inspector c7-mcp-server).
  6. 在中进行更改 src/ 目录并重建。

许可证

麻省理工学院

相关 MCP