MCP 服务器

removecolor.online 已作为一个模型上下文协议(MCP) 服务器开放。将它接入 Claude Code、Cursor、Codex 或任何兼容 MCP 的智能体,即可在你的 AI 工作流中直接移除颜色、转换灰度。MCP 与 REST API 共享同一账号、API 密钥和积分余额。

接入地址

https://removecolor.online/mcp

传输方式:Streamable HTTP(无状态)。每个请求相互独立 —— 无需会话管理。

身份验证

以 Bearer Token 方式携带 API 密钥 —— 与 REST API 相同的正式密钥(rc_live_…)。在控制台 → API 密钥中创建。

Authorization: Bearer rc_live_YOUR_KEY

生产端点不接受测试密钥(rc_test_…)。

可用工具

remove_color_from_image1 积分

移除目标颜色(或连通的颜色区域),返回透明 PNG。算法与参数和 REST API 完全一致。

{
  "image_base64": "…",          // required: PNG/JPEG/WebP, ≤ 5 MB
  "target_color": "#00FF00",    // hex color to remove
  "sample_x": 10,               // or sample the color at (x, y)
  "sample_y": 10,               //   (also the connected-mode seed)
  "tolerance": 20,              // 0–100, default 20
  "mode": "global",             // "global" | "connected", default "global"
  "edge_smooth": 2              // 0–10, default 2
}

同时提供 target_color 和取样点时,十六进制颜色为移除目标,取样点作为连通模式的种子。connected 模式只移除与种子点连通的区域。

convert_image_to_grayscale1 积分

使用 Rec.709 亮度标准将图片转换为灰度。

{
  "image_base64": "…"          // required: PNG/JPEG/WebP, ≤ 5 MB
}

get_image_processing_capabilities免费

返回支持的格式、大小/像素限制、处理选项以及各操作的积分消耗。无参数,完全免费。

返回格式

成功的工具调用会以图像内容块(base64 PNG)返回处理后的图片,并附带元数据块:

{
  "operation": "remove_color",
  "mime_type": "image/png",
  "width": 1920, "height": 1080,
  "credits_used": 1,
  "credits_remaining": 41,
  "removed_pixels": 812344,      // remove_color only
  "removed_percent": 39.1
}

积分

每次成功的 remove_color_from_image 或 convert_image_to_grayscale 调用固定消耗 1 个积分 —— 与 REST API 共用同一余额。
get_image_processing_capabilities 免费。
失败调用消耗 0 积分 —— 包括无效输入、不支持的图片、图片过大、积分不足、限流和处理错误。
积分用完了?请到设置 → 积分充值。

图片限制

输入格式:PNG、JPEG、WebP(按文件内容校验,而非文件名)。
Base64 载荷:每次工具调用的解码后图片不得超过 5 MB。
最大 2500 万像素;最大边长 8192 × 8192。
输出格式:PNG(移除颜色的结果带透明度)。
v1 不接受远程图片 URL —— 请以 base64 发送图片。更大的文件请使用REST API的 multipart 上传(最大 20 MB)。

客户端配置

将 rc_live_YOUR_KEY 替换为你自己的密钥 —— 切勿提交真实密钥。

Claude Code

claude mcp add --transport http removecolor https://removecolor.online/mcp \
  --header "Authorization: Bearer rc_live_YOUR_KEY"

或在 .mcp.json / ~/.claude.json 中配置:

{
  "mcpServers": {
    "removecolor": {
      "type": "http",
      "url": "https://removecolor.online/mcp",
      "headers": {
        "Authorization": "Bearer rc_live_YOUR_KEY"
      }
    }
  }
}

Cursor

Settings → MCP → Add server,或在 ~/.cursor/mcp.json 中:

{
  "mcpServers": {
    "removecolor": {
      "url": "https://removecolor.online/mcp",
      "headers": {
        "Authorization": "Bearer rc_live_YOUR_KEY"
      }
    }
  }
}

其他 MCP 客户端

任何支持 Streamable HTTP 远程服务器的客户端均可使用:将地址指向端点 URL,并设置 Authorization: Bearer 请求头。

错误处理

失败的工具调用返回 isError: true 及结构化错误。错误码与 REST API 一致:

UNAUTHORIZED	API 密钥缺失、无效或已吊销(HTTP 401)。
INVALID_INPUT	参数格式错误 —— base64 无效、十六进制颜色非法、容差超出范围、连通模式缺少取样点。
UNSUPPORTED_IMAGE	字节内容不是可解码的 PNG/JPEG/WebP 图片。
IMAGE_TOO_LARGE	超出 5 MB(解码后)/ 2500 万像素 / 8192 px 限制。
INSUFFICIENT_CREDITS	余额不足 1 积分。响应包含 credits_available 和 recharge_url。
RATE_LIMITED	触发每分钟或每日限流(HTTP 429)。
PROCESSING_FAILED	解码或处理失败/超时。未产生任何扣费。
INTERNAL_ERROR	意外的服务器错误。未产生任何扣费。

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "You do not have enough credits…",
    "credits_required": 1,
    "credits_available": 0,
    "recharge_url": "https://removecolor.online/settings/credits"
  }
}

隐私

网页工具(removecolor.online 首页与灰度转换器):图片完全在你的浏览器中处理,不会离开你的设备。
MCP 与 REST API:图片会上传到 removecolor.online 服务器处理 —— 这正是服务端 API 的工作方式。图片在内存中处理、绝不永久存储;仅记录用于计费的使用元数据(字节数、尺寸、耗时)。