catbox
这是一个用于Catbox.moe的Model Context Protocol (MCP) 服务器，Catbox.moe是一个免费的文件托管服务。它允许用户通过URL上传文件、管理相册，并直接从MCP客户端（如Claude Desktop、Claude Code等）删除文件。该服务器支持匿名和认证（使用userhash）操作。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"catbox": {
"args": [
"-y",
"catbox-mcp-server"
],
"command": "npx",
"env": {
"CATBOX_USERHASH": "your-catbox-userhash-here"
}
}
}
}该服务需要配置环境变量：CATBOX_USERHASH
可用工具 （7 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
url_upload 2 个参数 需填 1 项
通过 URL 上传文件到 Catbox
必填参数：url
delete_files 2 个参数 需填 2 项
删除已上传的文件
必填参数：files、userhash
create_album 4 个参数 需填 2 项
创建相册
必填参数：title、files
edit_album 5 个参数 需填 4 项
编辑相册（必须提供所有参数）
必填参数：short、title、files、userhash
add_to_album 3 个参数 需填 3 项
向相册添加文件
必填参数：short、files、userhash
remove_from_album 3 个参数 需填 3 项
从相册移除文件
必填参数：short、files、userhash
delete_album 2 个参数 需填 2 项
删除相册
必填参数：short、userhash
服务介绍
🐱 Catbox MCP 服务器
一个用于 Catbox.moe 的 Model Context Protocol (MCP) 服务器 —— 一个免费的文件托管服务。通过 URL 上传文件、管理相册，并直接从您的 MCP 客户端（如 Claude Desktop、Claude Code 等）删除文件。
⚠️ 重要：匿名用户 vs 认证用户
Catbox 有两个用户层级。理解这一点非常重要：
| 功能 | 🕶️ 匿名用户 | 🔑 带有用户哈希 |
|---|---|---|
| 上传文件 | ✅ | ✅ |
| 删除文件 | ❌ | ✅ |
| 创建相册 | ✅ (但不能后续编辑/删除) | ✅ (完全可管理) |
| 编辑相册 | ❌ | ✅ |
| 添加/移除相册文件 | ❌ | ✅ |
| 删除相册 | ❌ | ✅ |
您可以通过在 Catbox.moe 上传任何文件来获得免费的用户哈希 —— 请参阅 获取您的用户哈希。
✨ 功能
| 功能 | 描述 |
|---|---|
| ☁️ URL 上传 | 从任何公开可访问的 URL 上传文件 |
| 🗑️ 文件管理 | 删除您已上传的文件 |
| 🖼️ 相册管理 | 创建、编辑、添加到、移除和删除相册 |
🧰 工具
| 工具 | 描述 |
|---|---|
url_upload |
从公开可访问的 URL 上传文件 |
delete_files |
删除已上传的文件（需要用户哈希） |
create_album |
创建新相册 |
edit_album |
编辑相册标题/描述/文件（需要用户哈希） |
add_to_album |
将文件添加到相册（需要用户哈希） |
remove_from_album |
从相册中移除文件（需要用户哈希） |
delete_album |
删除相册（需要用户哈希） |
请参阅 用户哈希指南 以设置管理工具的身份验证。
📦 安装
通过 npm（推荐）
bash
npm install -g catbox-mcp-server
通过 npx（无需安装）
bash
npx -y catbox-mcp-server
从源代码安装
bash
git clone https://github.com/xxy9468615/catbox.git
cd catbox
npm install
node index.js
🔧 配置
Claude Desktop / Claude Code
将以下内容添加到您的 mcpServers 配置中：
json
{
"mcpServers": {
"catbox": {
"command": "npx",
"args": ["-y", "catbox-mcp-server"],
"env": {
"CATBOX_USERHASH": "your-catbox-userhash-here"
}
}
}
}
环境变量
| 变量 | 是否必需 | 默认值 | 描述 |
|---|---|---|---|
CATBOX_USERHASH |
❌ | — | 您的 Catbox 用户哈希，用于身份验证。设置此变量可以避免每次调用时都传递它。 |
💡 提示: 您可以通过传递参数的方式为每个工具调用覆盖用户哈希 —— 环境变量只是一个方便的默认值。
🔑 获取您的用户哈希
无需注册账户 —— 只需使用 Catbox 即可获得用户哈希：
- 前往 Catbox.moe
- 从您的计算机上传任意文件（或使用 API 上传 URL）
- 上传后，页面会显示您的用户哈希 —— 一个类似于
a1b2c3d4e5f6...的十六进制字符串 - 保存它 并与任何管理工具一起使用
- 您也可以在没有用户哈希的情况下上传文件时从 API 响应中获取用户哈希
💡 无用户哈希: 您可以上传文件并创建相册，但是：
- 您无法删除任何文件
- 匿名创建的相册是永久且不可修改的 —— 无法编辑或删除
- 要管理任何内容，您需要用户哈希
🚀 使用示例
从 URL 上传文件
json
{
"url": "https://example.com/image.jpg"
}
响应：
json
https://files.catbox.moe/abc123.jpg
使用用户哈希上传文件（以声明所有权）
json
{
"url": "https://example.com/image.jpg",
"userhash": "a1b2c3d4e5f6"
}### 创建相册
json
{
"title": "我的假期照片",
"files": "abc123.jpg def456.png",
"desc": "2026年夏季旅行",
"userhash": "a1b2c3d4e5f6"
}
向相册添加文件
json
{
"short": "album123",
"files": "ghi789.jpg jkl012.png",
"userhash": "a1b2c3d4e5f6"
}
删除文件
json
{
"files": "abc123.jpg def456.png",
"userhash": "a1b2c3d4e5f6"
}
🔗 链接
- Catbox.moe: https://catbox.moe
- Catbox API / 工具: https://catbox.moe/tools.php
- Catbox 常见问题解答: https://catbox.moe/faq.php
- GitHub 仓库: https://github.com/xxy9468615/catbox
📄 许可证
MIT
⚖️ 免责声明
此MCP服务器是一个非官方的社区工具，与Catbox LLC无关，未得到其认可或赞助。
您的责任
通过使用此工具，您同意遵守Catbox的服务条款：
- 您拥有您的内容 — 您必须有权上传、分享和存储通过此工具上传的任何文件
- 禁止非法使用 — 未经许可不得上传受版权保护的内容、恶意软件、间谍软件或任何违反适用法律的材料
- 禁止商业使用 — Catbox禁止在未经Catbox高管事先书面批准的情况下将其服务用于商业用途
- 禁止转售 — 您不得转售或向他人提供Catbox服务
- 禁止滥用 — 不得发送垃圾邮件、骚扰或损害Catbox的基础设施
无保修
此工具按**“原样”**提供，没有任何明示或暗示的保证。作者不对以下情况负责：
- 通过此工具上传或分享的任何内容
- 任何数据、文件或访问Catbox服务的丢失
- 使用或无法使用此工具导致的任何损害
- 最终用户违反Catbox服务条款的行为
使用风险自负。 如果您对特定内容或使用有疑虑，请联系Catbox：admin@catbox.moe。
☕ 支持Catbox
Catbox.moe提供一个免费的文件托管服务，无需注册账户。如果您觉得该服务有用，请考虑支持他们：
- Ko-fi: https://ko-fi.com/catboxmoe
- 传播消息 — 告诉其他人关于Catbox！
- 遵守规则 — 成为负责任的用户，让服务为大家持续运行 ❤️
