Next.js MCP Server

Next.js MCP サーバー

デモ

機能

• get-routers-info

  ルーターアナライザーは、Next.js アプリのディレクトリー構造をスキャンし、次の情報を含むすべての API ルートの情報を抽出します。

  • API パス
  • HTTP メソッド（GET、POST、PUT、DELETE など）
  • リクエストパラメーター
  • ステータスコード
  • リクエストとレスポンスのスキーマ

インストール

npm install next-mcp-server

pnpm を使用している場合は、次のようにします。

pnpm add next-mcp-server

使用方法

コマンドライン

MCP サーバーを直接実行できます。

npm run build
node dist/index.js

Docker

docker build -t mcp/next -f Dockerfile .
docker run mcp/next -d

Cursor で使用する場合は、~/.cursor または [projectDir]/.cursor の下に mcp.json を定義します。

{
  "mcpServers": {
    "next.js": {
      "url": "http://localhost:4857/sse"
    }
  }
}

ここでの url は、プロジェクト内の .env 設定によって異なる場合があります。

出力

このツールは各ルートの詳細情報を生成します。

[
  {
    "filePath": "/path/to/your/app/api/test/route.ts",
    "implementationPath": "/path/to/your/app/api/test/route.ts",
    "apiPath": "/api/test",
    "handlers": [
      {
        "method": "GET",
        "path": "/api/test",
        "functionSignature": "export async function GET(request: Request)",
        "description": "Get test data",
        "parameters": [],
        "statusCodes": [200]
      },
      {
        "method": "POST",
        "path": "/api/test",
        "functionSignature": "export async function POST(request: Request)",
        "description": "Create test data",
        "parameters": [],
        "requestBodySchema": "{ name: string }",
        "statusCodes": [201, 400]
      }
    ]
  }
]

開発

テストを実行するには、次のようにします。

npm run test

MCP サーバーをローカルで実行するには、次のようにします。

npm run build
node dist/index.js 

npm i の実行後、node_modules から実行するには、次のようにします。

node node_modules/next-mcp-server/dist/index.js

プレイグラウンドを実行するには、次のようにします。

pnpm --filter playground dev

仕組み

このツールは次の処理を行います。

1. Next.js アプリのディレクトリー構造をスキャンして、ルートファイルを探します
2. 各ルートファイルを分析し、HTTP メソッド、パス、パラメーターなどを抽出します
3. コメントからドキュメントを抽出します
4. すべての API ルートを構造化された形式で返します

制限事項

1. パスを指定してファイルシステムのディレクトリーにアクセスする性質上、ネットワーク経由でホストした場合は動作しません
2. Next.js App Router プロジェクトのみをサポートします

ライセンス

MIT