为智能体提供文件处理工具。

使用 Streamable HTTP 和 Bearer 身份验证,适用于支持自定义请求头的客户端。

当前 MCP 提供两个工具,不直接上传本地文件。请先通过 REST 上传,再将返回的 file_id 传给 redact_file。暂不提供远程网址抓取、OAuth 或 SSE。

连接设置

设置项取值
传输方式Streamable HTTP / 无状态 JSON-RPC
接口地址你配置的基础地址 + /mcp
身份验证在请求头中传入 Bearer 密钥
协议版本2025-03-26

各客户端配置格式不同,请按客户端文档设置带自定义请求头的连接。目前没有通用的一键安装命令。

初始化连接

可复制示例
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-03-26",
    "capabilities": {},
    "clientInfo": {
      "name": "your-client",
      "version": "1.0"
    }
  }
}

发送 initialized 通知后,调用 tools/list 获取可用工具结构。通知请求返回 202,不含结果正文。

工具 1 · redact_file

需提供已上传文件的 ID、输出模式和固定请求 ID。接口立即返回任务信息,文件完成后再下载。

可复制示例
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "redact_file",
    "arguments": {
      "file_id": "YOUR_UPLOADED_FILE_ID",
      "mode": "placeholder",
      "request_id": "unique-request-001"
    }
  }
}

工具 2 · get_result

可复制示例
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "get_result",
    "arguments": {
      "job_id": "YOUR_JOB_ID"
    }
  }
}

工具输出位于 result.content[].text ,内容为 JSON 字符串。解析后检查状态,完成时使用同一个 Bearer 密钥通过 REST 下载。同时检查 result.isError.

助手需要向用户说明

文件将离开用户设备进行处理。请确认替换模式,并使用有权处理的文件。排队不等于完成,下载路径不公开,也不保证移除所有敏感信息。

Runnable examples

Node.js 22+ · cURL + jq · Python MCP · Live REST demo