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

运行 playground：

pnpm --filter playground dev

工作原理

该工具会：

1. 扫描你的 Next.js 应用目录结构，查找路由文件
2. 分析每个路由文件，提取 HTTP 方法、路径、参数等
3. 从注释中提取文档
4. 返回所有 API 路由的结构化表示

限制

1. 由于需要按路径访问文件系统目录，如果托管在网络上，则无法运行
2. 仅支持 Next.js App Router 项目

许可证

MIT