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