Next.js Docs MCP

🚀 Next.js Docs MCP

Next.js Docs MCPは、ClaudeなどのAIエージェントにNext.jsのすべてのドキュメントURLを提供し、AIエージェントがユーザーのクエリに基づいて最適なドキュメントを選択できるようにする、Model Context Protocol (MCP) サーバーです。このサーバーにはNext.jsのドキュメントページの包括的な静的データベースが含まれており、AIエージェントがユーザーのクエリに基づいて最も関連性の高いドキュメントを分析して選択できるようになっています。

✨ 主な機能

• AIエージェントとの統合：ClaudeなどのAIエージェントが関連するドキュメントを分析して選択できるように、すべてのドキュメントURLを提供します。
• 包括的な静的データベース：すべてのカテゴリーにわたる200以上のNext.jsドキュメントURLが含まれています。
• 外部依存関係なし：API呼び出しやクローリングを必要としない純粋な静的URLデータベースです。
• 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
    }
  }
}

💻 使用例

すべてのNext.jsドキュメントURLを取得する

{
  "tool": "get_all_docs"
}

Claudeとの統合例

1. ユーザーが質問: "Next.jsのエラーを解消したいです"
2. Claudeが呼び出し: get_all_docs
3. MCPサーバーが返す: タイトル、説明、カテゴリーを含む200以上のNext.jsドキュメントURLすべて
4. Claudeがリストを分析し、関連するドキュメントを選択:
   • "Getting Started: Error Handling"
   • "Routing: Error Handling"
   • "API Routes Error Handling"
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以上のドキュメントページが含まれています。

• 入門ガイド
• ルーティング (App Router & Pages Router)
• データフェッチングパターン
• APIルート
• デプロイメントガイド
• パフォーマンス最適化
• ガイドとベストプラクティス

静的なアプローチにより、高速な応答時間と外部依存関係のない動作が保証されます。

📄 ライセンス

MIT License

🤝 コントリビューション

コントリビューションは大歓迎です！改善点については、自由にプルリクエストを送信またはイシューを開いてください。