MCP Server for Cursor Integration

Cursor 集成的 MCP 服务

一个将 Cursor 与 Coda.io 文档集成的托管上下文提供程序（MCP）服务。该服务通过查询 Coda.io 文档表格，提供上下文感知的响应。

功能

• 集成 Coda.io API
• 用于提升性能的缓存系统
• RESTful API 端点
• 支持多个 Coda 表格
• 健康检查和缓存管理端点

前提条件

• Node.js（v14 或更高版本）
• 可访问 API 的 Coda.io 账号
• 包含相关表格的 Coda.io 文档

设置

1. 克隆代码库
2. 安装依赖项：

   npm install
   

3. 根据 .env.example 创建 .env 文件：

   cp .env.example .env
   

4. 使用你的 Coda.io 凭据更新 .env 文件：
   • CODA_API_TOKEN：你的 Coda.io API 令牌
   • CODA_DOC_ID：你的 Coda.io 文档 ID

运行服务

开发模式：

npm run dev

生产模式：

npm start

使用 ngrok 创建隧道

使用 ngrok 将本地服务开放到互联网：

1. 安装 ngrok：

   npm install -g ngrok
   

2. 启动 MCP 服务（在单独的终端中）：

   npm start
   

3. 创建到本地服务的隧道：

   ngrok http 3000
   

4. Ngrok 将提供一个公共 URL（例如，https://xxxx-xxxx-xxxx.ngrok-free.app）

5. 使用 ngrok URL 更新 mcp.json 文件：

   {
     "mcpServers": {
       "Coda MCP": {
         "url": "https://xxxx-xxxx-xxxx.ngrok-free.app/context",
         "method": "POST",
         "headers": {
           "Content-Type": "application/json"
         }
       }
     }
   }
   

注意：除非你拥有付费账号，否则每次重启 ngrok 时 URL 都会变化。URL 变化后，请务必使用新的 URL 更新 mcp.json 文件。

API 端点

获取上下文

POST /context
Body: { "query": "your search query" }

健康检查

GET /health

缓存管理

POST /cache/clear
GET /cache/stats

Coda.io 集成

服务要求你的 Coda.io 文档中包含以下表格：

• Jira Tickets
• API Documentation
• Architecture Decisions

你可以修改 src/services/mcp.service.js 中的表格名称，使其与你的 Coda.io 文档结构相匹配。

错误处理

服务针对以下情况提供了全面的错误处理：

• API 请求失败
• 无效查询
• 缓存管理
• 服务错误

贡献

欢迎提交问题和改进建议！