为智能体提供文件处理工具。
使用 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.
助手需要向用户说明
文件将离开用户设备进行处理。请确认替换模式,并使用有权处理的文件。排队不等于完成,下载路径不公开,也不保证移除所有敏感信息。