Integrations

Supports containerized deployment of the MCP server through Docker, allowing for isolated and portable execution of the route analysis functionality.
Analyzes Next.js application routes and provides detailed information about API endpoints, including paths, HTTP methods, parameters, status codes, and request/response schemas. Useful for documentation, testing, and API management.

Next.js MCP Server

A utility tool that analyzes your Next.js application routes and provides detailed information about them.

Demo

Overview

get-routers-infoThe Router Analyzer scans your Next.js app directory structure and extracts information about all API routes, including:
- API paths
- HTTP methods (GET, POST, PUT, DELETE, etc.)
- Request parameters
- Status codes
- Request and response schemas

This is particularly useful for documentation, testing, or integrating with API management tools.

Installation

npm install next-mcp-server

Or if you're using pnpm:

pnpm add next-mcp-server

Usage

Command Line

You can run the mcp server directly:

npm run build
node dist/index.js

Docker

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

Output

The tool generates detailed information about each route:

[
  {
    "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]
      }
    ]
  }
]

Development

To run tests:

node run-router-test.js

How It Works

The tool:

Scans your Next.js app directory structure for route files
Analyzes each route file to extract HTTP methods, paths, parameters, etc.
Extracts documentation from comments
Returns a structured representation of all your API routes

License

MIT

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

A utility tool that analyzes Next.js application routes and provides detailed information about API paths, HTTP methods, parameters, status codes, and request/response schemas.