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提升開發效率，享受強大的文檔獲取和庫解析功能。