Next.js Docs MCP

🚀 Next.js Docs MCP

Next.js Docs MCP是一個模型上下文協議（MCP）服務器，它為Claude等AI智能體提供所有Next.js文檔的URL，以便進行智能文檔選擇。該服務器包含一個全面的Next.js文檔頁面靜態數據庫，使AI智能體能夠根據用戶查詢分析並選擇最相關的文檔。

✨ 主要特性

• AI智能體集成：為Claude和其他AI智能體提供所有文檔URL，以便分析和選擇相關文檔。
• 全面的靜態數據庫：包含200多個涵蓋所有類別的Next.js文檔URL。
• 無外部依賴：純靜態URL數據庫，無需進行API調用或網頁爬取。
• Claude優化：專門為Claude設計，可智能選擇相關文檔。
• npx就緒：無需本地安裝，可通過任何MCP客戶端使用npx運行。

📦 安裝指南

要求

• Node.js 18或更高版本
• VS Code、Cursor、Windsurf、Claude Desktop、Goose、LM Studio或任何其他MCP客戶端

安裝步驟

標準配置

標準配置適用於大多數工具：

{
  "mcpServers": {
    "nextjs-docs-mcp": {
      "command": "npx",
      "args": ["@taiyokimura/nextjs-docs-mcp@latest"]
    }
  }
}

在VS Code中安裝 在VS Code Insiders中安裝

特定客戶端設置

claude mcp add nextjs-docs-mcp -- npx @taiyokimura/nextjs-docs-mcp@latest

claude mcp remove nextjs-docs-mcp

code --add-mcp '{"name":"nextjs-docs-mcp","command":"npx","args":["@taiyokimura/nextjs-docs-mcp@latest"]}'

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "nextjs-docs-mcp": {
      "type": "local",
      "command": [
        "npx",
        "@taiyokimura/nextjs-docs-mcp@latest"
      ],
      "enabled": true
    }
  }
}

📚 詳細文檔

可用工具

get_all_docs

獲取所有Next.js文檔的URL，供AI智能體分析並選擇相關文檔。 參數：無需參數 描述：此工具返回一個按類別組織的全面的Next.js文檔URL列表。像Claude這樣的AI智能體可以使用此列表分析用戶查詢並選擇最相關的文檔頁面。該工具提供結構化數據，包括標題、URL、描述和類別，以便進行智能文檔選擇。 響應格式：該工具返回一個格式化列表，包含：

• 文檔標題
• Next.js文檔的直接URL
• 簡要描述
• 類別分類
• 可用文檔的總數

💻 使用示例

獲取所有Next.js文檔URL

{
  "tool": "get_all_docs"
}

Claude集成示例

1. 用戶提問：“我想解決Next.js的錯誤”
2. Claude調用：get_all_docs
3. MCP服務器返回：所有200多個帶有標題、描述和類別的Next.js文檔URL
4. Claude分析列表並選擇相關文檔：
   • "入門指南：錯誤處理"
   • "路由：錯誤處理"
   • "API路由錯誤處理"
5. Claude向用戶提供有針對性的文檔鏈接

與Claude Code集成

# 在Claude Code內使用
claude mcp add nextjs-docs-mcp -- npx @taiyokimura/nextjs-docs-mcp@latest

之後，當用戶提出與Next.js相關的問題時，Claude可以自動調用該工具。

🔧 技術細節

構建包

npm run build

發佈到npm

1. 在package.json中更新包名稱為你的作用域（例如，@taiyokimura/nextjs-docs-mcp）
2. 構建項目：npm run build
3. 發佈：npm publish

更新文檔URL

服務器使用Next.js文檔URL的靜態數據庫。要更新或添加新的文檔URL，請修改src/index.ts中的NEXTJS_DOCS_DATABASE對象。該數據庫按類別組織，包含200多個文檔頁面，涵蓋：

• 入門指南
• 路由（應用路由器和頁面路由器）
• 數據獲取模式
• API路由
• 部署指南
• 性能優化
• 指南和最佳實踐 這種靜態方法確保了快速響應時間，且無需外部依賴。

📄 許可證

本項目採用MIT許可證。

貢獻

歡迎貢獻！請隨時提交拉取請求或提出問題以進行改進。