MCP 服务 API

提供 MCP（Model Context Protocol）服务的连通性检测功能。

基础路径

/projects/:projectId/mcp

所有端点均需要 JWT Bearer Token 认证（combinedAuth 中间件）。

所有 MCP 端点受限流保护：每用户每分钟 5 次请求。

POST /projects/:projectId/mcp/test-connection

测试指定 MCP 服务的连通性，验证远程 MCP 服务器是否可达并正常响应。

内置 SSRF 防护：URL 不允许指向私网地址。

Path 参数

参数	类型	必填	说明
`projectId`	string	是	项目 ID

Body 参数（JSON）

参数	类型	必填	说明
`name`	string	是	MCP 服务名称
`url`	string	是	MCP 服务 URL（必须为合法 URL 格式，且不能指向私网地址）
`headers`	Record<string, string>	否	自定义请求头（如认证信息）
`timeout`	number	否	连接超时时间（毫秒）

请求示例

json

{
  "name": "my-mcp-service",
  "url": "https://mcp.example.com/sse",
  "headers": {
    "Authorization": "Bearer xxx"
  },
  "timeout": 10000
}

响应 200

连接测试结果，包含连接状态和可用工具列表。

json

{
  "success": true,
  "tools": [
    {
      "name": "search",
      "description": "Search the web",
      "inputSchema": { ... }
    }
  ]
}

错误码

状态码	说明
400	参数缺失、JSON 格式无效、URL 格式错误或指向私网地址
401	未认证
403	无项目访问权限
429	超出限流（每分钟 5 次）