Context7 MCP 服务端部署与使用全指南为 LLM 与 AI 编程助手注入最新版代码文档【免费下载链接】context7Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors项目地址: https://gitcode.com/gh_mirrors/co/context7本篇技术指南围绕 Context7 Platform 仓库中的 MCP 服务端upstash/context7-mcp展开完整讲解如何在 Cursor、VS Code、Claude Desktop、Claude Code、Zed、Copilot Coding Agent 等主流 MCP 客户端中安装与配置 Context7深入解析resolve-library-id与query-docs两个核心工具的调用参数与底层实现并覆盖 Docker 部署、本地开发调试与常见故障排查。读完本文你将能够独立完成 Context7 在各种客户端环境下的安装、调用与排错让 LLM 获得实时、版本准确的库文档告别过时训练数据与幻觉 API。为什么需要 Context7LLM 文档缺失的痛点大型语言模型对常用库的了解往往停留在训练数据截止的时刻由此产生三类典型问题❌ 代码示例过时基于一年前的训练数据❌ 幻觉出实际并不存在的 API❌ 对旧版本包给出泛泛的通用回答。Context7 的解法是直接从文档源头拉取最新、且与特定版本匹配的文档与代码示例并直接注入到你的 prompt 上下文中。它让 AI 编程助手在回答库相关问题时不再依赖记忆而是查询真实、新鲜的文档内容。使用方式在 prompt 中触发 Context7Context7 的设计哲学是自然书写按需触发。你只需在 prompt 末尾加上use context7例如Next.js ile app router kullanan basit bir proje oluştur. use context7PostgreSQL kimlik bilgileriyle şehir değeri olan satırları silmek için bir betik oluştur. use context7工作流分三步自然书写你的 prompt指示 LLM 使用use context7获得可直接运行的代码答案——无需切换标签页、没有不存在的幻觉 API、不会生成过时代码。从仓库源码看服务端在 packages/mcp/src/index.ts 中通过instructions字段向模型声明了适用边界凡是涉及库、框架、SDK、API、CLI 工具或云服务的问题包括 API 语法、配置、版本迁移、库级调试、安装步骤、CLI 用法都应调用 Context7 获取最新文档而重构、从零写脚本、业务逻辑调试、代码审查等通用编程场景则不适用。进阶提示直接指定库 ID 与版本指定库 ID若已知目标库可在 prompt 中直接写出 Context7 库 ID跳过库匹配环节直接取文档Implement basic authentication with Supabase. use library /supabase/supabase for API and docs.斜杠语法/组织/项目能精确告诉 Context7 加载哪个库的文档。指定版本在 prompt 中提及版本号即可获取对应版本的文档例如How do I set up Next.js 14 middleware? use context7Context7 会自动匹配相应版本。环境要求与安装运行前提Node.js ≥ v18.0.0注意当前仓库中 packages/mcp/package.json 已将engines字段更新为node 20.18.1建议按此版本执行一个 MCP 客户端如 Cursor、Devin Desktop、Claude Desktop 等。通过 Smithery 一键安装若使用 Claude Desktop可通过 Smithery 自动安装npx -y smithery/cli install upstash/context7-mcp --client claude仓库中的 packages/mcp/smithery.yaml 声明了该 MCP 以 HTTP 类型启动且无需额外配置。各客户端手动配置下面给出主流客户端的完整配置 JSON均可直接复制使用。Cursor进入Settings→Cursor Settings→MCP→Add new global MCP server将配置写入~/.cursor/mcp.json全局或项目目录下的.cursor/mcp.json仅该项目{ mcpServers: { context7: { command: npx, args: [-y, upstash/context7-mcplatest] } } }备选使用 Bun 运行{ mcpServers: { context7: { command: bunx, args: [-y, upstash/context7-mcplatest] } } }备选使用 Deno 运行{ mcpServers: { context7: { command: deno, args: [run, --allow-net, npm:upstash/context7-mcp] } } }Devin Desktop将以下配置加入 Devin Desktop 的 MCP 配置文件{ mcpServers: { context7: { command: npx, args: [-y, upstash/context7-mcplatest] } } }VS Code将以下配置加入 VS Code 的 MCP 配置文件{ servers: { Context7: { type: stdio, command: npx, args: [-y, upstash/context7-mcplatest] } } }注意VS Code 使用servers键而非mcpServers且需要type: stdio。Zed可通过 Zed 扩展安装也可写入 Zedsettings.json{ context_servers: { Context7: { source: custom, command: npx, args: [-y, upstash/context7-mcp, --api-key, YOUR_API_KEY] } } }Zed 的配置中可直接通过--api-key参数传入 API Key这是该客户端区别于其他配置的要点。Claude Code执行一条命令即可claude mcp add --scope user context7 -- npx -y upstash/context7-mcplatestClaude Desktop将以下配置加入 Claude Desktop 的claude_desktop_config.json{ mcpServers: { Context7: { command: npx, args: [-y, upstash/context7-mcplatest] } } }Copilot Coding Agent在 Repository → Settings → Copilot → Coding agent → MCP configuration 的mcp部分加入{ mcpServers: { context7: { type: http, url: https://mcp.context7.com/mcp, tools: [query-docs, resolve-library-id] } } }Copilot 走的是 HTTP 远程端点方式并显式声明启用的工具列表。核心工具详解resolve-library-id 与 query-docsContext7 MCP 服务端只暴露两个工具服务端代码位于 packages/mcp/src/index.ts工具作用必填参数resolve-library-id将通用库名解析为 Context7 兼容的库 IDquery用户问题或任务用于相关性排序、libraryName要搜索的库名query-docs用 Context7 兼容库 ID 获取库文档libraryId精确的 Context7 库 ID如/mongodb/docs、/vercel/next.js、query要检索相关文档的问题或任务底层调用链从源码看两个工具分别对应 packages/mcp/src/lib/api.ts 中的两个 API 函数resolve-library-id→searchLibraries()请求GET {CONTEXT7_API_BASE_URL}/v2/libs/search携带query与libraryName两个查询参数返回匹配库列表含库 ID、名称、描述、代码片段数量、来源信誉等级与基准评分query-docs→fetchLibraryContext()请求GET {CONTEXT7_API_BASE_URL}/v2/context携带query与libraryId返回文档文本并直接作为工具结果注入模型上下文。两个调用均设置了 60 秒超时API_TIMEOUT_MS并会对 429限流/配额超限、404库不存在、401API Key 无效需以ctx7sk前缀开头等状态码返回可读的错误提示。值得注意的实现细节必须先解析库 ID服务端指令要求模型在调用query-docs前必须先调用resolve-library-id获得合法库 ID除非用户已在 prompt 中直接给出/org/project或/org/project/version格式的 ID参数别名容错服务端通过z.preprocess实现了参数别名重写如userQuery/question→query、libraryName/libraryID→libraryId以兼容 LLM 客户端回显工具描述措辞而导致的参数名幻觉该行为在 packages/mcp/test/integration.test.ts 中有端到端测试验证调用次数限制每个问题每个工具最多调用 3 次超限后应使用已有最佳结果敏感信息约束query参数会被发送至 Context7 API 处理服务端明确要求不要在查询中携带 API Key、密码、凭据、个人数据或专有代码。Docker 部署偏好容器化运行时可参考以下步骤仓库自带 packages/mcp/Dockerfile构建镜像在项目根目录创建Dockerfile可参考仓库中现成版本——其生产阶段基于node:lts-alpine暴露 8080 端口并以--transport http --port 8080启动然后执行docker build -t context7-mcp .构建前请确保 Docker Desktop或 Docker daemon已运行。配置 MCP 客户端将客户端配置改为调用 Docker 命令。以cline_mcp_settings.json为例{ mcpServers: { Context7: { autoApprove: [], disabled: false, timeout: 60, command: docker, args: [run, -i, --rm, context7-mcp], transportType: stdio } } }注意args中的镜像名必须与docker build -t使用的标签一致不同客户端对配置结构如mcpServers与servers的差异要求不同请按所用客户端调整。本地开发与调试构建项目克隆仓库后安装依赖并编译pnpm i pnpm run build仓库采用 pnpm workspace 管理见根目录 pnpm-workspace.yamlMCP 服务端源码位于packages/mcp。本地运行配置示例修改某个 MCP 客户端的配置指向本地源码入口tsx直接运行 TypeScript 源码{ mcpServers: { context7: { command: npx, args: [tsx, /path/to/folder/context7-mcp/src/index.ts] } } }服务端 CLI 参数与传输模式从 packages/mcp/src/index.ts 可以看出服务端支持以下命令行选项选项说明默认值--transport stdio\|http传输类型stdio--port numberHTTP 传输监听端口3000--api-key key认证用 API Keystdio 模式无也可用CONTEXT7_API_KEY环境变量两个传输模式存在参数互斥HTTP 模式不允许--api-key应改用 HTTP 层的请求头鉴权stdio 模式不允许--port。HTTP 模式下服务端还提供匿名端点/mcp与 OAuth 保护端点/mcp/oauth以及/ping、/.well-known/oauth-protected-resource等辅助路由。用 MCP Inspector 测试npx -y modelcontextprotocol/inspector npx upstash/context7-mcplatestMCP Inspector 会启动交互式调试界面可实时调用两个工具查看返回。仓库的 packages/mcp/test/integration.test.ts 提供了覆盖 stdio/HTTP 两种传输、新旧两代协议的端到端测试可作为验证部署正确性的参考。故障排查ERR_MODULE_NOT_FOUND若遇到模块找不到错误可改用bunx替代npx{ mcpServers: { context7: { command: bunx, args: [-y, upstash/context7-mcplatest] } } }这在npx无法正确安装或解析包的环境中通常能解决模块解析问题。ESM 解析问题若报Error: Cannot find module uriTemplate.js之类的错误可尝试带--experimental-vm-modules标志运行{ mcpServers: { context7: { command: npx, args: [-y, --node-options--experimental-vm-modules, upstash/context7-mcp1.0.6] } } }MCP 客户端报错按以下顺序依次尝试去掉包名中的latest后缀改用bunx运行改用deno运行确认使用 Node v18 或更高版本确保npx具备原生 fetch 支持。补充代理与自定义 CA源码视角若处于受限网络环境从 packages/mcp/src/lib/api.ts 可以看到服务端会自动读取HTTPS_PROXY/HTTP_PROXY环境变量配置代理也可通过NODE_EXTRA_CA_CERTS指定自定义 CA 证书CONTEXT7_API_URL环境变量可覆盖默认的 API 基础地址默认为https://context7.com/api便于本地联调或私有化部署参见 packages/mcp/src/lib/constants.ts。免责声明与许可证Context7 项目由社区贡献虽然尽力维持高质量但无法保证所有库文档的准确性、完整性或安全性。平台上列出的项目由其各自所有者开发和维护而非 Context7 本身。如遇可疑、不当或潜在有害内容可使用项目页面的报告按钮及时反馈平台会认真对待所有报告并快速审查。使用 Context7 即表示你自行承担相应风险。本仓库含 packages/mcp 下的 MCP 服务端采用 MIT 许可证开源其中服务端源码公开而 API 后端、解析引擎与爬取引擎属于私有组件不在本仓库范围内。【免费下载链接】context7Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors项目地址: https://gitcode.com/gh_mirrors/co/context7创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Context7 MCP 服务端部署与使用全指南为 LLM 与 AI 编程助手注入最新版代码文档【免费下载链接】context7Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors项目地址: https://gitcode.com/gh_mirrors/co/context7本篇技术指南围绕 Context7 Platform 仓库中的 MCP 服务端upstash/context7-mcp展开完整讲解如何在 Cursor、VS Code、Claude Desktop、Claude Code、Zed、Copilot Coding Agent 等主流 MCP 客户端中安装与配置 Context7深入解析resolve-library-id与query-docs两个核心工具的调用参数与底层实现并覆盖 Docker 部署、本地开发调试与常见故障排查。读完本文你将能够独立完成 Context7 在各种客户端环境下的安装、调用与排错让 LLM 获得实时、版本准确的库文档告别过时训练数据与幻觉 API。为什么需要 Context7LLM 文档缺失的痛点大型语言模型对常用库的了解往往停留在训练数据截止的时刻由此产生三类典型问题❌ 代码示例过时基于一年前的训练数据❌ 幻觉出实际并不存在的 API❌ 对旧版本包给出泛泛的通用回答。Context7 的解法是直接从文档源头拉取最新、且与特定版本匹配的文档与代码示例并直接注入到你的 prompt 上下文中。它让 AI 编程助手在回答库相关问题时不再依赖记忆而是查询真实、新鲜的文档内容。使用方式在 prompt 中触发 Context7Context7 的设计哲学是自然书写按需触发。你只需在 prompt 末尾加上use context7例如Next.js ile app router kullanan basit bir proje oluştur. use context7PostgreSQL kimlik bilgileriyle şehir değeri olan satırları silmek için bir betik oluştur. use context7工作流分三步自然书写你的 prompt指示 LLM 使用use context7获得可直接运行的代码答案——无需切换标签页、没有不存在的幻觉 API、不会生成过时代码。从仓库源码看服务端在 packages/mcp/src/index.ts 中通过instructions字段向模型声明了适用边界凡是涉及库、框架、SDK、API、CLI 工具或云服务的问题包括 API 语法、配置、版本迁移、库级调试、安装步骤、CLI 用法都应调用 Context7 获取最新文档而重构、从零写脚本、业务逻辑调试、代码审查等通用编程场景则不适用。进阶提示直接指定库 ID 与版本指定库 ID若已知目标库可在 prompt 中直接写出 Context7 库 ID跳过库匹配环节直接取文档Implement basic authentication with Supabase. use library /supabase/supabase for API and docs.斜杠语法/组织/项目能精确告诉 Context7 加载哪个库的文档。指定版本在 prompt 中提及版本号即可获取对应版本的文档例如How do I set up Next.js 14 middleware? use context7Context7 会自动匹配相应版本。环境要求与安装运行前提Node.js ≥ v18.0.0注意当前仓库中 packages/mcp/package.json 已将engines字段更新为node 20.18.1建议按此版本执行一个 MCP 客户端如 Cursor、Devin Desktop、Claude Desktop 等。通过 Smithery 一键安装若使用 Claude Desktop可通过 Smithery 自动安装npx -y smithery/cli install upstash/context7-mcp --client claude仓库中的 packages/mcp/smithery.yaml 声明了该 MCP 以 HTTP 类型启动且无需额外配置。各客户端手动配置下面给出主流客户端的完整配置 JSON均可直接复制使用。Cursor进入Settings→Cursor Settings→MCP→Add new global MCP server将配置写入~/.cursor/mcp.json全局或项目目录下的.cursor/mcp.json仅该项目{ mcpServers: { context7: { command: npx, args: [-y, upstash/context7-mcplatest] } } }备选使用 Bun 运行{ mcpServers: { context7: { command: bunx, args: [-y, upstash/context7-mcplatest] } } }备选使用 Deno 运行{ mcpServers: { context7: { command: deno, args: [run, --allow-net, npm:upstash/context7-mcp] } } }Devin Desktop将以下配置加入 Devin Desktop 的 MCP 配置文件{ mcpServers: { context7: { command: npx, args: [-y, upstash/context7-mcplatest] } } }VS Code将以下配置加入 VS Code 的 MCP 配置文件{ servers: { Context7: { type: stdio, command: npx, args: [-y, upstash/context7-mcplatest] } } }注意VS Code 使用servers键而非mcpServers且需要type: stdio。Zed可通过 Zed 扩展安装也可写入 Zedsettings.json{ context_servers: { Context7: { source: custom, command: npx, args: [-y, upstash/context7-mcp, --api-key, YOUR_API_KEY] } } }Zed 的配置中可直接通过--api-key参数传入 API Key这是该客户端区别于其他配置的要点。Claude Code执行一条命令即可claude mcp add --scope user context7 -- npx -y upstash/context7-mcplatestClaude Desktop将以下配置加入 Claude Desktop 的claude_desktop_config.json{ mcpServers: { Context7: { command: npx, args: [-y, upstash/context7-mcplatest] } } }Copilot Coding Agent在 Repository → Settings → Copilot → Coding agent → MCP configuration 的mcp部分加入{ mcpServers: { context7: { type: http, url: https://mcp.context7.com/mcp, tools: [query-docs, resolve-library-id] } } }Copilot 走的是 HTTP 远程端点方式并显式声明启用的工具列表。核心工具详解resolve-library-id 与 query-docsContext7 MCP 服务端只暴露两个工具服务端代码位于 packages/mcp/src/index.ts工具作用必填参数resolve-library-id将通用库名解析为 Context7 兼容的库 IDquery用户问题或任务用于相关性排序、libraryName要搜索的库名query-docs用 Context7 兼容库 ID 获取库文档libraryId精确的 Context7 库 ID如/mongodb/docs、/vercel/next.js、query要检索相关文档的问题或任务底层调用链从源码看两个工具分别对应 packages/mcp/src/lib/api.ts 中的两个 API 函数resolve-library-id→searchLibraries()请求GET {CONTEXT7_API_BASE_URL}/v2/libs/search携带query与libraryName两个查询参数返回匹配库列表含库 ID、名称、描述、代码片段数量、来源信誉等级与基准评分query-docs→fetchLibraryContext()请求GET {CONTEXT7_API_BASE_URL}/v2/context携带query与libraryId返回文档文本并直接作为工具结果注入模型上下文。两个调用均设置了 60 秒超时API_TIMEOUT_MS并会对 429限流/配额超限、404库不存在、401API Key 无效需以ctx7sk前缀开头等状态码返回可读的错误提示。值得注意的实现细节必须先解析库 ID服务端指令要求模型在调用query-docs前必须先调用resolve-library-id获得合法库 ID除非用户已在 prompt 中直接给出/org/project或/org/project/version格式的 ID参数别名容错服务端通过z.preprocess实现了参数别名重写如userQuery/question→query、libraryName/libraryID→libraryId以兼容 LLM 客户端回显工具描述措辞而导致的参数名幻觉该行为在 packages/mcp/test/integration.test.ts 中有端到端测试验证调用次数限制每个问题每个工具最多调用 3 次超限后应使用已有最佳结果敏感信息约束query参数会被发送至 Context7 API 处理服务端明确要求不要在查询中携带 API Key、密码、凭据、个人数据或专有代码。Docker 部署偏好容器化运行时可参考以下步骤仓库自带 packages/mcp/Dockerfile构建镜像在项目根目录创建Dockerfile可参考仓库中现成版本——其生产阶段基于node:lts-alpine暴露 8080 端口并以--transport http --port 8080启动然后执行docker build -t context7-mcp .构建前请确保 Docker Desktop或 Docker daemon已运行。配置 MCP 客户端将客户端配置改为调用 Docker 命令。以cline_mcp_settings.json为例{ mcpServers: { Context7: { autoApprove: [], disabled: false, timeout: 60, command: docker, args: [run, -i, --rm, context7-mcp], transportType: stdio } } }注意args中的镜像名必须与docker build -t使用的标签一致不同客户端对配置结构如mcpServers与servers的差异要求不同请按所用客户端调整。本地开发与调试构建项目克隆仓库后安装依赖并编译pnpm i pnpm run build仓库采用 pnpm workspace 管理见根目录 pnpm-workspace.yamlMCP 服务端源码位于packages/mcp。本地运行配置示例修改某个 MCP 客户端的配置指向本地源码入口tsx直接运行 TypeScript 源码{ mcpServers: { context7: { command: npx, args: [tsx, /path/to/folder/context7-mcp/src/index.ts] } } }服务端 CLI 参数与传输模式从 packages/mcp/src/index.ts 可以看出服务端支持以下命令行选项选项说明默认值--transport stdio\|http传输类型stdio--port numberHTTP 传输监听端口3000--api-key key认证用 API Keystdio 模式无也可用CONTEXT7_API_KEY环境变量两个传输模式存在参数互斥HTTP 模式不允许--api-key应改用 HTTP 层的请求头鉴权stdio 模式不允许--port。HTTP 模式下服务端还提供匿名端点/mcp与 OAuth 保护端点/mcp/oauth以及/ping、/.well-known/oauth-protected-resource等辅助路由。用 MCP Inspector 测试npx -y modelcontextprotocol/inspector npx upstash/context7-mcplatestMCP Inspector 会启动交互式调试界面可实时调用两个工具查看返回。仓库的 packages/mcp/test/integration.test.ts 提供了覆盖 stdio/HTTP 两种传输、新旧两代协议的端到端测试可作为验证部署正确性的参考。故障排查ERR_MODULE_NOT_FOUND若遇到模块找不到错误可改用bunx替代npx{ mcpServers: { context7: { command: bunx, args: [-y, upstash/context7-mcplatest] } } }这在npx无法正确安装或解析包的环境中通常能解决模块解析问题。ESM 解析问题若报Error: Cannot find module uriTemplate.js之类的错误可尝试带--experimental-vm-modules标志运行{ mcpServers: { context7: { command: npx, args: [-y, --node-options--experimental-vm-modules, upstash/context7-mcp1.0.6] } } }MCP 客户端报错按以下顺序依次尝试去掉包名中的latest后缀改用bunx运行改用deno运行确认使用 Node v18 或更高版本确保npx具备原生 fetch 支持。补充代理与自定义 CA源码视角若处于受限网络环境从 packages/mcp/src/lib/api.ts 可以看到服务端会自动读取HTTPS_PROXY/HTTP_PROXY环境变量配置代理也可通过NODE_EXTRA_CA_CERTS指定自定义 CA 证书CONTEXT7_API_URL环境变量可覆盖默认的 API 基础地址默认为https://context7.com/api便于本地联调或私有化部署参见 packages/mcp/src/lib/constants.ts。免责声明与许可证Context7 项目由社区贡献虽然尽力维持高质量但无法保证所有库文档的准确性、完整性或安全性。平台上列出的项目由其各自所有者开发和维护而非 Context7 本身。如遇可疑、不当或潜在有害内容可使用项目页面的报告按钮及时反馈平台会认真对待所有报告并快速审查。使用 Context7 即表示你自行承担相应风险。本仓库含 packages/mcp 下的 MCP 服务端采用 MIT 许可证开源其中服务端源码公开而 API 后端、解析引擎与爬取引擎属于私有组件不在本仓库范围内。【免费下载链接】context7Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors项目地址: https://gitcode.com/gh_mirrors/co/context7创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
` 完全指南：从右向左的函数组合与 Store Enhancer 应用)
