Next.js Docs MCP

🚀 Next.js Docs MCP

Next.js Docs MCP是一个模型上下文协议（MCP）服务器，它为Claude等AI智能体提供所有Next.js文档的URL，以便进行智能文档选择。该服务器包含一个全面的Next.js文档页面静态数据库，使AI智能体能够根据用户查询分析并选择最相关的文档。

✨ 主要特性

• AI智能体集成：为Claude和其他AI智能体提供所有文档URL，以便分析和选择相关文档。
• 全面的静态数据库：包含200多个涵盖所有类别的Next.js文档URL。
• 无外部依赖：纯静态URL数据库，无需进行API调用或网页爬取。
• Claude优化：专门为Claude设计，可智能选择相关文档。
• npx就绪：无需本地安装，可通过任何MCP客户端使用npx运行。

📦 安装指南

要求

• Node.js 18或更高版本
• VS Code、Cursor、Windsurf、Claude Desktop、Goose、LM Studio或任何其他MCP客户端

安装步骤

标准配置

标准配置适用于大多数工具：

{
  "mcpServers": {
    "nextjs-docs-mcp": {
      "command": "npx",
      "args": ["@taiyokimura/nextjs-docs-mcp@latest"]
    }
  }
}

在VS Code中安装 在VS Code Insiders中安装

特定客户端设置

claude mcp add nextjs-docs-mcp -- npx @taiyokimura/nextjs-docs-mcp@latest

claude mcp remove nextjs-docs-mcp

code --add-mcp '{"name":"nextjs-docs-mcp","command":"npx","args":["@taiyokimura/nextjs-docs-mcp@latest"]}'

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "nextjs-docs-mcp": {
      "type": "local",
      "command": [
        "npx",
        "@taiyokimura/nextjs-docs-mcp@latest"
      ],
      "enabled": true
    }
  }
}

📚 详细文档

可用工具

get_all_docs

获取所有Next.js文档的URL，供AI智能体分析并选择相关文档。 参数：无需参数 描述：此工具返回一个按类别组织的全面的Next.js文档URL列表。像Claude这样的AI智能体可以使用此列表分析用户查询并选择最相关的文档页面。该工具提供结构化数据，包括标题、URL、描述和类别，以便进行智能文档选择。 响应格式：该工具返回一个格式化列表，包含：

• 文档标题
• Next.js文档的直接URL
• 简要描述
• 类别分类
• 可用文档的总数

💻 使用示例

获取所有Next.js文档URL

{
  "tool": "get_all_docs"
}

Claude集成示例

1. 用户提问：“我想解决Next.js的错误”
2. Claude调用：get_all_docs
3. MCP服务器返回：所有200多个带有标题、描述和类别的Next.js文档URL
4. Claude分析列表并选择相关文档：
   • "入门指南：错误处理"
   • "路由：错误处理"
   • "API路由错误处理"
5. Claude向用户提供有针对性的文档链接

与Claude Code集成

# 在Claude Code内使用
claude mcp add nextjs-docs-mcp -- npx @taiyokimura/nextjs-docs-mcp@latest

之后，当用户提出与Next.js相关的问题时，Claude可以自动调用该工具。

🔧 技术细节

构建包

npm run build

发布到npm

1. 在package.json中更新包名称为你的作用域（例如，@taiyokimura/nextjs-docs-mcp）
2. 构建项目：npm run build
3. 发布：npm publish

更新文档URL

服务器使用Next.js文档URL的静态数据库。要更新或添加新的文档URL，请修改src/index.ts中的NEXTJS_DOCS_DATABASE对象。该数据库按类别组织，包含200多个文档页面，涵盖：

• 入门指南
• 路由（应用路由器和页面路由器）
• 数据获取模式
• API路由
• 部署指南
• 性能优化
• 指南和最佳实践 这种静态方法确保了快速响应时间，且无需外部依赖。

📄 许可证

本项目采用MIT许可证。

贡献

欢迎贡献！请随时提交拉取请求或提出问题以进行改进。