🚀 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 Code（推荐）
使用Claude Code CLI添加MCP服务器：
claude mcp add nextjs-docs-mcp -- npx @taiyokimura/nextjs-docs-mcp@latest
若需要移除：
claude mcp remove nextjs-docs-mcp
Claude Desktop
遵循MCP安装指南并使用上述标准配置。
- 指南：https://modelcontextprotocol.io/quickstart/user
Cursor
前往Cursor设置 → MCP → 添加新的MCP服务器。
使用以下设置：
- 名称：nextjs-docs-mcp
- 类型：命令
- 命令：npx
- 参数：@taiyokimura/nextjs-docs-mcp@latest
- 自动启动：开启（可选）
VS Code
通过CLI添加：
code --add-mcp '{"name":"nextjs-docs-mcp","command":"npx","args":["@taiyokimura/nextjs-docs-mcp@latest"]}'
或者使用上述安装链接。
LM Studio
添加MCP服务器，设置如下：
- 命令：npx
- 参数：["@taiyokimura/nextjs-docs-mcp@latest"]
Goose
高级设置 → 扩展 → 添加自定义扩展：
- 类型：STDIO
- 命令：npx
- 参数：@taiyokimura/nextjs-docs-mcp@latest
- 启用：是
opencode
示例~/.config/opencode/opencode.json文件：
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"nextjs-docs-mcp": {
"type": "local",
"command": [
"npx",
"@taiyokimura/nextjs-docs-mcp@latest"
],
"enabled": true
}
}
}
Qodo Gen
打开Qodo Gen → 连接更多工具 → + 添加新的MCP → 粘贴上述标准配置 → 保存。
Windsurf
遵循Windsurf MCP文档并使用上述标准配置。
- 文档：https://docs.windsurf.com/windsurf/cascade/mcp
📚 详细文档
可用工具
get_all_docs
获取所有Next.js文档的URL，供AI智能体分析并选择相关文档。 参数：无需参数 描述：此工具返回一个按类别组织的全面的Next.js文档URL列表。像Claude这样的AI智能体可以使用此列表分析用户查询并选择最相关的文档页面。该工具提供结构化数据，包括标题、URL、描述和类别，以便进行智能文档选择。 响应格式：该工具返回一个格式化列表，包含：
- 文档标题
- Next.js文档的直接URL
- 简要描述
- 类别分类
- 可用文档的总数
💻 使用示例
获取所有Next.js文档URL
{
"tool": "get_all_docs"
}
Claude集成示例
- 用户提问：“我想解决Next.js的错误”
- Claude调用：
get_all_docs - MCP服务器返回：所有200多个带有标题、描述和类别的Next.js文档URL
- Claude分析列表并选择相关文档：
- "入门指南：错误处理"
- "路由：错误处理"
- "API路由错误处理"
- Claude向用户提供有针对性的文档链接
与Claude Code集成
# 在Claude Code内使用
claude mcp add nextjs-docs-mcp -- npx @taiyokimura/nextjs-docs-mcp@latest
之后，当用户提出与Next.js相关的问题时，Claude可以自动调用该工具。
🔧 技术细节
构建包
npm run build
发布到npm
- 在
package.json中更新包名称为你的作用域（例如，@taiyokimura/nextjs-docs-mcp） - 构建项目：
npm run build - 发布：
npm publish
更新文档URL
服务器使用Next.js文档URL的静态数据库。要更新或添加新的文档URL，请修改src/index.ts中的NEXTJS_DOCS_DATABASE对象。该数据库按类别组织，包含200多个文档页面，涵盖：
- 入门指南
- 路由（应用路由器和页面路由器）
- 数据获取模式
- API路由
- 部署指南
- 性能优化
- 指南和最佳实践 这种静态方法确保了快速响应时间，且无需外部依赖。
📄 许可证
本项目采用MIT许可证。
贡献
欢迎贡献！请随时提交拉取请求或提出问题以进行改进。