Skip to main content
Glama
enesjakozh
vertile-ai

Next.js MCP Server

by vertile-ai
OverviewSchemaRelated ServersScoreDiscussions
TypeScript

Next.js MCP Server

Demo

Router analysis demo

Related MCP server: MCP Integration Proxy

Features

  • get-routers-info

    The 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

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

For cursor usage, define a mcp.json under ~/.cursor or [projectDir]/.cursor

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

The url here could vary based on your .env settings within the project.

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:

npm run test

To run the mcp server locally:

npm run build node dist/index.js

To run it from node_modules after npm i:

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

To run the playground:

pnpm --filter playground dev

How It Works

The tool:

  1. Scans your Next.js app directory structure for route files

  2. Analyzes each route file to extract HTTP methods, paths, parameters, etc.

  3. Extracts documentation from comments

  4. Returns a structured representation of all your API routes

Restrictions

  1. Due to the nature of accessing filesystem directory by path, it will not work if hosted over network

  2. Only supports Next.js App router projects

License

MIT

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vertile-ai/next-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server