AI导哈

文档查询服务

一个与Coda.io集成的托管上下文提供服务器，通过查询Coda.io文档表格提供上下文感知的响应。

  • by knyengera
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 knyengera/mcp-server

使用说明

用于游标集成的MCP服务器

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

特性

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

先决条件

  • Node.js（v14或更高版本）
  • 拥有API访问权限的Coda.io帐户
  • 带有相关表格的Coda.io文档

设置

  1. 克隆存储库
  2. 安装依赖项：
    npm install
  3. 创建一个 .env 文件基于 .env.example:
    cp .env.example .env
  4. 更新 .env 使用您的Coda.io凭据文件：
    • 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. 更新您的 mcp.json 具有ngrok URL的文件：

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

注意：除非您有付费帐户，否则每次重新启动ngrok时，ngrok URL都会更改。请确保更新您的 mcp.json 文件更改时使用新的URL。

API终点

获取上下文

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

健康检查

GET /health

缓存管理

POST /cache/clear
GET /cache/stats

Coda.io集成

服务器需要Coda.io文档中的以下表：

  • Jira门票
  • API文档
  • 体系结构决策

您可以在中修改表名 src/services/mcp.service.js 以匹配您的Coda.io文档结构。

错误处理

该服务器包括全面的错误处理功能，用于：

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

贡献

请随时提交问题和增强请求！

相关 MCP