Context7 MCP

🚀 上下文7

上下文7是一个用于AI编码助手的强大MCP（机器学习模型服务）平台。它通过提供详细的文档和库ID解析功能，显著提升了开发效率。该项目由社区贡献，并得到了广泛的支持。

🚀 快速开始

上下文7是一个强大的MCP平台，为AI编码助手提供支持。借助其详细的文档和库ID解析功能，能有效提升开发效率。

📦 安装指南

使用npx运行

npx -y @upstash/context7-mcp@latest

配置示例

在你的MCP配置文件中添加以下内容：

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

✨ 主要特性

可用工具

工具列表

1. resolve-library-id：将通用库名称转换为上下文7兼容的库ID。
   • libraryName（必需）
2. get-library-docs：使用上下文7兼容的库ID获取文档。
   • context7CompatibleLibraryID（必需）
   • topic（可选）：聚焦于特定主题（如“路由”、“钩子”）。
   • tokens（可选，默认5000）：返回的最大令牌数。值低于配置的DEFAULT_MINIMUM_TOKENS时会自动提升到该值。

环境变量配置

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

🔧 技术细节

开发信息

克隆项目并安装依赖

bun i

构建项目

bun run build

本地配置示例

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["tsx", "/path/to/folder/context7-mcp/src/index.ts"]
    }
  }
}

使用MCP Inspector测试

运行以下命令：

npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest

常见问题排查

模块未找到错误（ERR_MODULE_NOT_FOUND）

如果遇到此错误，尝试使用bunx代替npx：

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

ESM解析问题

若出现类似Error: Cannot find module 'uriTemplate.js'的错误，可以尝试添加实验性VM模块标志：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "--node-options=--experimental-vm-modules",
        "@upstash/context7-mcp@1.0.6"
      ]
    }
  }
}

MCP客户端错误

1. 尝试去掉@latest从包名。
2. 尝试使用bunx作为替代。
3. 尝试使用deno作为替代。
4. 确保你使用的是Node.js版本支持所需功能。

📄 许可证

免责声明

上下文7是一个社区驱动的项目，旨在为AI编码助手提供增强的功能。虽然已经尽力确保内容准确，但不保证适用于所有场景。建议在生产环境中使用前进行充分测试。

通过以上配置和工具，你可以充分利用上下文7提升开发效率，享受强大的文档获取和库解析功能。