AI导哈

API发现与调用服务

一个动态加载OpenAPI规范并通过三个工具进行发现和执行的服务，使AI助手能够发现和调用Cakemail API。

  • by cakemail
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 cakemail/apidoc.mcp.cakemail.com

使用说明

apidoc.mcp.cakemail.com

MCP服务器，让人工智能助手发现并调用Cakemail API。动态加载OpenAPI规范，并通过三个工具进行发现和执行。部署在Vercel上。

建筑

api.cakemail.dev/openapi.json  →  Loaded into memory on first request
                                        ↓
                                  MCP Server (Vercel)
                                  ├── list_endpoints   (browse/search)
                                  ├── get_endpoint     (full details)
                                  └── call_api         (execute)
                                        ↑
                                  AI Assistant (Claude, Cursor, etc.)
  • 源：从以下位置获取OpenAPI规范 https://api.cakemail.dev/openapi.json
  • 规格尺寸：~470KB，222个操作，497个模式
  • 运输：MCP流式HTTP协议

MCP工具

list_endpoints

使用可选筛选器浏览可用的API终结点。

参数 类型 必填 说明
tag string no 按类别筛选（例如活动、联系人、帐户）
search string no 在路径、摘要或操作ID中搜索

get_endpoint

获取特定端点的完整详细信息（参数、请求/响应模式）。

参数 类型 必填 说明
operationId string no 端点操作ID（例如listCampaigns）
path string no neneneba API路径（例如/活动）
method string no HTTP方法（例如GET、POST）

提供其中之一 operationId 或两者 path + method.

call_api

从Cakemail API读取数据（仅限GET）。用于使用真实数据验证API行为。

参数 类型 必填 说明
path string yes neneneba API路径（例如campaigns，/contacts/123）
query object no 将参数作为键值对进行查询

认证

支持两种方法：

  • 基本认证 --使用您的Cakemail电子邮件和密码（建议MCP客户使用）
  • 持有者代币 -管理员API密钥或来自的Cakemail访问令牌 /api/auth

生成您的基本身份验证凭据

echo -n 'you@example.com:your-password' | base64

通过以下方式获取令牌 /api/auth

curl -X POST https://apidoc.mcp.cakemail.com/api/auth \
  -H "Content-Type: application/json" \
  -d '{"username":"you@example.com","password":"your-password"}'

连接到MCP服务器

克劳德代码

claude mcp add cakemail-api \
  --transport http \
  https://apidoc.mcp.cakemail.com/api/mcp \
  --header "Authorization: Basic BASE64_ENCODED_CREDENTIALS"

任何MCP客户端

{
  "mcpServers": {
    "cakemail-api": {
      "type": "streamable-http",
      "url": "https://apidoc.mcp.cakemail.com/api/mcp",
      "headers": {
        "Authorization": "Basic BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

API终点

端点 方法 身份验证 描述
/api/mcp POST/GET 基本或承载 MCP可流式HTTP端点
/api/auth POST 无 使用Cakemail凭据获取访问令牌
/api/usage GET Admin API key 工具使用情况统计信息。可选： ?since=2026-03-01&until=2026-03-31

环境变量

变量 描述
API_KEY 用于服务身份验证的管理员API密钥
SUPABASE_URL 共享Supabase项目URL（与kb.mcp相同）
SUPABASE_SERVICE_KEY Supabase服务角色键

发展

npm install
npm test            # run tests
npm run test:watch  # run tests in watch mode

相关 MCP