Context7 MCP

Context7 MCP是一个基于 Model Context Protocol（MCP）的上下文增强工具，专为 AI 编程助手设计。它通过直接从官方来源获取最新、版本特定的文档和代码示例，增强 AI 助手的上下文感知能力，从而提升代码生成的准确性和实用性。开发者只需在提示中添加 `use context7`，即可获得实时更新的文档支持。

核心功能

Context7 提供了多项核心功能，帮助开发者更高效地进行开发工作：

• 实时文档检索：直接从官方文档源获取最新的代码示例和 API 说明，确保 AI 助手生成的内容始终基于最新数据。
• 版本特定支持：根据项目使用的具体版本提供精确的文档和代码示例，避免因版本差异导致的错误。
• 跨平台兼容：支持多种流行的 AI 开发工具，如 Cursor、Claude Desktop 等，方便开发者在不同环境中使用。

安装方法

Context7 可以通过多种方式安装，包括使用 npx、bunx 或 deno。以下是几种常见的安装方式：

npx -y @upstash/context7-mcp@latest

bunx -y @upstash/context7-mcp@latest

deno run -A https://deno.land/x/context7@latest/mod.ts

安装完成后，可以在 package.json 中添加如下配置，以便在 AI 工具中使用 Context7：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

使用方法

使用 Context7 非常简单，只需在提示中添加 use context7，即可触发实时文档检索功能。以下是几个使用示例：

Create a script to delete rows where the city is empty in PostgreSQL. use context7

Create a basic Next.js project with app router. use context7

此外，还可以通过启动服务的方式使用 Context7：

context7-mcp start --port 3001

如果需要自定义配置，可以使用如下方式：

const c
    port: 3002,
    logLevel: 'debug',
    apiEndpoints: ['api.example.com', 'docs.example.com']
};

const { Context7MCP } = require('@upstash/context7-mcp');

async function main() {
    const mcp = new Context7MCP(config);
    await mcp.start();
}

main().catch(console.error);

使用场景

Context7 适用于多种开发场景，特别是在以下情况下能发挥重要作用：

• 需要最新代码示例和文档的开发者，尤其是在使用 Node.js 项目时。
• 在 AI 编程助手（如 Cursor、Claude Desktop）中集成实时文档支持，提升代码生成的准确性。
• 需要根据项目使用的具体版本提供精确文档和代码示例的场景。

配置与调试

Context7 提供了多种配置选项，开发者可以根据需要进行调整。例如，可以通过环境变量设置默认端口和日志级别：

export DEFAULT_PORT=3002
export LOG_LEVEL=info

如果在使用过程中遇到问题，可以尝试以下解决方案：

• 如果出现模块未找到错误，请尝试使用 bunx 代替 npx。
• 如果遇到 ESM 解析问题，可以尝试添加 --node-opti> 参数。
• 确保使用 Node.js v18 或更高版本以获得 npx 的原生 fetch 支持。

最佳实践

为了获得最佳使用体验，建议遵循以下最佳实践：

• 始终使用最新版本以获得最佳性能和安全更新。
• 在生产环境中，建议将端口配置为非默认值以提高安全性。
• 定期检查文档更新，保持项目知识的及时性。

通过合理配置和使用，Context7 能够显著提升 AI 编程助手的上下文感知能力，帮助开发者更高效、准确地完成开发任务。