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.
安装
先决条件
- （建议使用18+版本）
- （通常随Node.js一起提供）或 包子
选项1：从npm安装（建议用户使用）
发布后，全局安装服务器：
npm install -g c7-mcp-server这将使 c7-mcp-server 命令在系统范围内可用，允许MCP客户端启动它。
选项2：从源代码安装（用于开发）
- 克隆存储库：
git clone
cd c7-mcp-server- 安装依赖项：
npm install
# or if using Bun
# bun install- 构建服务器：
npm run build- 在本地链接命令：
npm link
# or if using Bun
# bun link这将使 c7-mcp-server 命令在本地计算机上可用，用于测试和开发。
用法
此服务器设计为由MCP运行 客户端 应用程序，通常不直接由最终用户执行（测试除外）。客户端启动 c7-mcp-server 它们使用MCP协议通过标准输入/输出（stdio）进行通信。
使用客户端配置（示例：Claude Desktop）
要将此服务器与像Claude Desktop这样的客户端一起使用，您需要将其添加到客户端的配置文件中。
- 确保
c7-mcp-server在全球范围内安装(npm install -g c7-mcp-server)或本地链接(npm link).
- 编辑客户端的配置文件（例如。，
claude_desktop_config.json):
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json
- 在下面添加条目
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 ...
}
}- 重新启动客户端应用程序（例如，Claude Desktop）。客户端现在将启动
c7-mcp-server在后台并连接到它。
MCP检验员测试
您可以直接使用MCP检查器测试服务器：
- 确保
c7-mcp-server全局安装或本地链接。
- 运行检查器，告诉它执行您的服务器命令：
npx @modelcontextprotocol/inspector c7-mcp-server- 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字符串数组。
发展
- 克隆存储库。
- 安装依赖项(
npm install或bun install). - 构建服务器(
npm run build).使用npm run dev用于在开发过程中自动重建和启动。 - 本地测试链接(
npm link或bun link). - 使用以下工具进行测试 MCP检查员 (
npx @modelcontextprotocol/inspector c7-mcp-server). - 在中进行更改
src/目录并重建。
