MCP - 模型上下文协议

NEXTDEVKIT 集成了 模型上下文协议 (MCP) 服务器，为 AI 代理提供增强的上下文和文档访问能力。推荐使用 Context7 MCP 服务器，它为 AI 代理提供对 NEXTDEVKIT 完整文档的直接访问。

什么是 MCP？

模型上下文协议 (MCP) 允许 AI 代理实时访问外部数据源和工具。MCP 使 AI 能够在对话过程中查询实时文档、API 和其他资源，而不是仅依赖训练数据。

Context7 MCP 集成

NEXTDEVKIT 预配置了 Context7，为 AI 代理提供全面访问：

• 完整的 NEXTDEVKIT 文档
• API 参考
• 配置指南
• 最佳实践
• 故障排除资源

安装与设置

NEXTDEVKIT 在 .ruler/mcp.json 中预配置了 Context7：

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

应用 MCP 配置

# 将 MCP 配置应用到所有支持的 AI 代理
ruler apply --with-mcp

# 仅应用到特定代理
ruler apply --agents cursor --with-mcp

重要提示：Ruler 只是配置了 MCP 服务器设置。您仍需要在具体的 AI IDE 设置中手动开启 MCP 功能。配置文件已准备就绪，但激活需要在每个工具中手动设置。

这将自动为支持的 AI 代理配置 Context7 访问。

Cursor 配置

1. 启用 MCP 支持，在 Cursor 设置中启用
2. 运行 Ruler 应用 MCP 配置：

ruler apply --agents cursor --with-mcp

其他 AI 代理

Ruler 支持多个 AI 代理的 MCP 配置。具体代理设置说明请查看 Ruler 文档。

使用 Context7

配置完成后，您的 AI 代理可以通过以下问题访问 NEXTDEVKIT 文档：

• "NEXTDEVKIT 中如何配置身份验证？"
• "推荐的部署流程是什么？"
• "如何设置数据库？"
• "显示项目结构指南"

AI 将自动通过 Context7 查询 NEXTDEVKIT 文档，并提供准确、最新的答案。

优势

🔍 始终最新

• AI 访问实时文档，而不是过时的训练数据
• 最新功能和更新自动可用

📖 全面上下文

• 可访问完整的项目文档
• 详细的配置指南和示例

⚡ 即时访问

• 无需手动搜索文档
• AI 自动检索相关信息

🎯 上下文化响应

• 针对 NEXTDEVKIT 实现的特定答案
• 包含项目中的实际代码示例

预配置文档

Context7 提供对所有 NEXTDEVKIT 文档的访问，包括：

• 入门 指南
• 配置 文档
• 部署 说明
• 功能 实现指南
• API 参考
• 故障排除 资源

高级用法

如需高级 MCP 配置或自定义服务器，修改 .ruler/mcp.json 并运行：

ruler apply --with-mcp

配置将自动分发到所有支持的 AI 代理。

故障排除

如果 Context7 无法正常工作：

1. 在 AI IDE 中启用 MCP：确保在您的 AI 工具设置中手动启用了 MCP 功能
2. 验证配置：检查 .ruler/mcp.json 是否包含 Context7 服务器
3. 重新应用规则：运行 ruler apply --with-mcp 刷新配置
4. 重启 AI 代理：应用 MCP 更改后重启您的 AI 应用程序
5. 检查连接：确保可访问互联网以便与 Context7 服务器通信