Next 路由分析

@vertile-ai/next-mcp-server
0 Stars 26 次浏览 vertile-ai 更新于 2026-08-23

一个实用工具，用于分析 Next.js 应用程序路由，并提供有关 API 路径、HTTP 方法、参数、状态码以及请求/响应模式的详细信息。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

服务介绍

Next.js MCP 服务器

一个实用工具，用于分析您的 Next.js 应用程序路由，并提供关于它们的详细信息。

演示

Router analysis demo

概览

  • get-routers-info

    路由分析器会扫描您的 Next.js 应用程序目录结构，并提取所有 API 路由的信息，包括：

    • API 路径
    • HTTP 方法 (GET, POST, PUT, DELETE 等)
    • 请求参数
    • 状态码
    • 请求和响应模式

这对于文档编写、测试或与 API 管理工具集成特别有用。

安装

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

输出

该工具为每个路由生成详细的报告：

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

开发

要运行测试：

node run-router-test.js

工作原理

该工具：

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

许可证

MIT

查看源码 项目主页