MCP · Tools

MCP ToolsMCP Tools

MCP Tools 定义智能体可调用的工具函数，支持工具注册、Schema 定义、同步/异步调用及超时处理。MCP Tools define callable tool functions for agents, supporting tool registration, Schema definition, sync/async invocation and timeout handling.

工具注册

开发者通过 tools/register 端点注册新工具。注册后即刻生效，无需重启服务。

POST /mcp/tools/register
{
  "name": "web_search",
  "description": "搜索互联网内容",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {"type": "string", "description": "搜索关键词"},
      "num_results": {"type": "integer", "default": 10}
    },
    "required": ["query"]
  }
}

Schema 定义

每个工具使用 JSON Schema 定义输入参数，支持类型校验、默认值、枚举约束、正则匹配等。

同步/异步调用

同步调用：适用于 < 5s 的快速工具，直接返回结果。
异步调用：适用于耗时操作，返回 task_id，通过 Webhook 或轮询获取结果。

返回格式

{
  "content": [
    {"type": "text", "text": "搜索结果..."},
    {"type": "image", "data": "base64...", "mimeType": "image/png"}
  ],
  "isError": false
}

超时处理

默认超时 30 秒，可通过 _meta.timeout 自定义。超时后自动返回 isError: true 并附带超时说明。