Animatool MCP

MCPAI代理

提供方 Moeblack

AI代理 stdio · 本地进程 API Key 社区 / 第三方 ClaudeCursor
查看接入方式

一个独立的MCP服务器和Python客户端,用于在本地或云端ComfyUI上执行Anima工作流并将生成图片以base64形式返回给MCP客户端。

一句话选型结论

按资料字段整理

Animatool MCP 属于AI代理类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude、Cursor,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

MCP服务Python本地部署ComfyUI集成图片生成AI工作流

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
pip install comfyui-animatool

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Animatool MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Moeblack上游标注的维护方 Moeblack
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.5 KB
来自项目仓库与上游目录的原文,未做删改

animatool-mcp

> [!WARNING]
> 暂不支持 Cherry Studio
> Cherry Studio 的 MCP 客户端未正确处理 ImageContent 类型,会将 base64 图片数据作为纯文本字符串返回,而非渲染为图片。请使用正确实现 MCP 规范的客户端。

一个独立的 MCP Server + Python 客户端:通过标准 ComfyUI Server API(/prompt、/history/、/view?...)在本地或云端 ComfyUI 上执行 Anima 工作流,并把生成图片以 base64 形式返回给 Cursor/Claude 等 MCP 客户端原生显示。

> 重要:本项目不需要安装到 ComfyUI/custom_nodes/。但你仍然需要一台可访问的 ComfyUI Server(本机或云端),并且云端已经把模型权重放到 models/ 下(按文件名加载)。


安装

方式一:使用 uvx (推荐)

无需手动安装 Python 包,直接在 Cursor 配置中使用 uvx 运行(需安装 uv):```json
{
"mcpServers": {
"animatool": {
"command": "uvx",
"args": ["--from", "comfyui-animatool", "animatool-mcp"],
"env": {
"COMFYUI_URL": "http://127.0.0.1:8188"
}
}
}
}


### 方式二:使用 pip```bash
pip install comfyui-animatool

Cursor 配置(MCP)

如果你使用 pip 安装,请在 .cursor/mcp.json 中配置:```json
{
"mcpServers": {
"animatool": {
"command": "animatool-mcp",
"env": {
"COMFYUI_URL": "http://127.0.0.1:8188"
}
}
}
}


然后重启 Cursor,确保 MCP 状态为 Running。

---

## 云端/远程 ComfyUI(推荐做法)

### COMFYUI_URL 该填什么?

- **本机默认**:`http://127.0.0.1:8188`
- **带路径前缀的反代**:例如 `https://example.com/comfy/`(注意建议以 `/` 结尾,避免丢路径前缀)

### 1) 最佳实践:用隧道/VPN 让 ComfyUI 变成“内网可达”

ComfyUI 默认几乎没有鉴权能力,把它直接暴露到公网非常危险。建议使用:

- Tailscale / ZeroTier / Cloudflare Tunnel / 自建 VPN
- 或者反向代理 + HTTPS + 鉴权(Bearer / Basic / 自定义 Header)

### 2) 配置鉴权(可选)

本项目支持“有些云端需要、有些不需要”的混合场景。你可以在 `.cursor/mcp.json` 里通过 `env` 注入:

#### Bearer Token```json
{
"mcpServers": {
"animatool": {
"command": "animatool-mcp",
"env": {
"COMFYUI_URL": "https://your-host.example.com:8188",
"ANIMATOOL_BEARER_TOKEN": "YOUR_TOKEN"
}
}
}
}

Basic Auth```json

{
"mcpServers": {
"animatool": {
"command": "animatool-mcp",
"env": {
"COMFYUI_URL": "https://your-host.example.com:8188",
"ANIMATOOL_BASIC_USER": "user",
"ANIMATOOL_BASIC_PASS": "pass"
}
}
}
}


#### 自定义 Header(通用,推荐)```json
{
"mcpServers": {
"animatool": {
"command": "animatool-mcp",
"env": {
"COMFYUI_URL": "https://your-host.example.com:8188",
"ANIMATOOL_HEADERS_JSON": "{\"X-API-Key\":\"xxx\",\"CF-Access-Client-Id\":\"...\",\"CF-Access-Client-Secret\":\"...\"}"
}
}
}
}

> Windows/JSON 转义提示:ANIMATOOL_HEADERS_JSON 本身是一个 JSON 字符串,所以内部的双引号需要转义(如上所示)。

3) 自签名证书/SSL 校验

如果你的云端是自签名证书,可以临时关闭校验(不推荐长期使用):```json
{
"mcpServers": {
"animatool": {
"command": "animatool-mcp",
"env": {
"COMFYUI_URL": "https://your-host.example.com:8188",
"ANIMATOOL_SSL_VERIFY": "false"
}
}
}
}


---

## CLI(可选)

用于本地自测(不依赖 MCP 客户端):```bash
animatool-generate --comfyui-url http://127.0.0.1:8188 --json-file payload.json

生态系统 (Ecosystem)

animatool-mcp 是 AnimaTool 生态的一部分,推荐搭配以下项目使用以获得最佳体验:

1. ComfyUI-AnimaTool

本项目的官方 ComfyUI 插件版本。如果你是 ComfyUI 重度用户,推荐直接安装插件版,它包含了完整的 expert 知识库和更多高级功能。

2. SillyTavern MCP Client

想在 SillyTavern (酒馆) 里画图?

  • 使用 SillyTavern MCP Client 连接本工具(支持 stdio/http)。
  • 搭配 SillyTavern Tool Use Fix 获得最佳的图片显示体验(自动合并消息、原生渲染)。

环境变量速查

环境变量 说明 默认值
COMFYUI_URL ComfyUI Server base URL http://127.0.0.1:8188
ANIMATOOL_TIMEOUT 请求超时秒 600
ANIMATOOL_POLL_INTERVAL 轮询间隔秒 1
ANIMATOOL_SSL_VERIFY SSL 校验 true
ANIMATOOL_BEARER_TOKEN Bearer Token (空)
ANIMATOOL_BASIC_USER / ANIMATOOL_BASIC_PASS Basic Auth (空)
ANIMATOOL_HEADERS_JSON 自定义 Header JSON (空)
ANIMATOOL_DOWNLOAD_IMAGES 是否保存图片到本地 false
ANIMATOOL_OUTPUT_DIR 本地保存目录 ./animatool_outputs
COMFYUI_MODELS_DIR models 目录(用于本机预检查) (空)
ANIMATOOL_CHECK_MODELS 是否启用预检查 true

常见问题

Q: 报错连接不上 /prompt?

  • 检查 COMFYUI_URL 是否可达(云端建议先在浏览器访问 COMFYUI_URL/system_stats)
  • 如果有鉴权,请确认 /prompt、/history、/view 都在同一套鉴权规则下
  • 常见坑:反代只给 /prompt 放行了,但 /view 被 401/403 拦住,会导致“生成成功但取图失败”

Q: 报错找不到模型?

本工具提交的是一个包含 UNETLoader/CLIPLoader/VAELoader 的工作流模板,加载的是云端磁盘上的文件名。请确认云端 models/ 下至少存在:

  • models/diffusion_models/anima-preview.safetensors
  • models/text_encoders/qwen_3_06b_base.safetensors
  • models/vae/qwen_image_vae.safetensors

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Animatool MCP 怎么安装?

在客户端按下面的安装命令接入:pip install comfyui-animatool。装完在客户端配置里引用同一个包或端点。

Animatool MCP 怎么在 Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Animatool MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Animatool MCP 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Animatool MCP 支持哪些客户端?

资料标注支持 Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Animatool MCP 能提供哪些能力?

资料显示能力标签包括 AI工作流、Python、Claude。具体工具清单以官方文档为准。

Animatool MCP 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Animatool MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。