{"id":"moeblack-comfyui-animatool","name":"ComfyUI-AnimaTool","homepage":null,"repo_url":"https://github.com/Moeblack/ComfyUI-AnimaTool","category":"ai-ml","subcategories":[],"tags":["ai-ml","multimedia","image-generation","comfyui","mcp","http-api","python","tool-use","anime"],"what_it_does":"ComfyUI-AnimaTool provides tool interfaces (MCP server, ComfyUI-compatible HTTP routes, and an optional FastAPI server/CLI) that let an AI agent generate Anima anime/illustration images via a running ComfyUI instance. It supports structured prompts, aspect ratio presets, history/reroll, and batch generation (repeat and batch_size), and includes optional LoRA injection behavior.","use_cases":["AI agent-driven generation of anime/illustration images using Anima models hosted in ComfyUI","Chat-based image tool-use where outputs should render natively in MCP-capable clients (Cursor/Claude, etc.)","Programmatic image generation pipelines with HTTP endpoints (health/schema/history/generate/reroll)","Iterative generation workflows using reroll based on prior generation history","Batch/queue generation for multiple independent outputs and in-task multi-sample latent batches"],"not_for":["Production-grade, internet-exposed public APIs without additional security hardening","Use cases requiring strict determinism across runs (seed/randomness behavior is implementation-dependent)","Environments where you cannot run/host ComfyUI locally or ensure remote ComfyUI access and model files"],"best_when":"You have a local or reachable ComfyUI with the required Anima model checkpoints installed, and you want an agent-friendly tool interface that can return images directly to chat clients.","avoid_when":"You need a formally specified OpenAPI contract or SDKs out of the box, or you require clearly documented rate limits, retry semantics, and idempotency guarantees for safe automated retries.","alternatives":["Native ComfyUI REST/queue APIs with custom prompting/orchestration","Other ComfyUI tool wrappers exposing HTTP endpoints or MCP servers","SillyTavern with compatible image-generation backends (without this specific MCP/HTTP wrapper)"],"af_score":62.5,"security_score":36.2,"reliability_score":30.0,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:50:33.317686+00:00","interface":{"has_rest_api":true,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Optional bearer token / custom headers for remote ComfyUI access (ANIMATOOL_BEARER_TOKEN, ANIMATOOL_HEADERS_JSON)"],"oauth":false,"scopes":false,"notes":"The README describes optional authorization only for remote ComfyUI via a bearer token or custom headers. No first-class user authentication/authorization model (accounts, scopes, API keys) is documented for the AnimaTool endpoints themselves."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Self-hosted tool wrapper; operational costs are primarily compute/GPU time for ComfyUI and model hosting."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":62.5,"security_score":36.2,"reliability_score":30.0,"mcp_server_quality":60.0,"documentation_accuracy":70.0,"error_message_quality":null,"error_message_notes":"Examples include friendly messages for missing model files and troubleshooting guidance for common ComfyUI connection/model/resolution issues. However, the README excerpt does not show structured API error codes or a documented error schema for the tool endpoints.","auth_complexity":85.0,"rate_limit_clarity":10.0,"tls_enforcement":40.0,"auth_strength":35.0,"scope_granularity":0.0,"dependency_hygiene":50.0,"secret_handling":60.0,"security_notes":"TLS is not specified in the README (examples use plain http://127.0.0.1:8188). Authentication/authorization for remote ComfyUI is optional and appears to rely on bearer token/custom headers rather than strong scoped access control. Secrets are referenced as environment variables (ANIMATOOL_BEARER_TOKEN, ANIMATOOL_HEADERS_JSON), which is generally safer than hardcoding, but there is no documented guidance about logging redaction or strict secret handling. The dependency manifest excerpt does not include vulnerability/lockfile information, so dependency hygiene cannot be verified.","uptime_documented":0.0,"version_stability":40.0,"breaking_changes_history":30.0,"error_recovery":50.0,"idempotency_support":"false","idempotency_notes":"No explicit idempotency guarantees are documented. Given generation tasks and queue behavior, retries may produce additional images unless clients implement their own deduplication.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Required parameters must include specific safety tags (safe/sensitive/nsfw/explicit) and artist names must include '@'.","Remote ComfyUI cannot reliably use LoRA sidecar listing that depends on COMFYUI_MODELS_DIR/model filesystem access; list behavior may differ by deployment.","MCP image rendering may require client-side fixes/preview versions (e.g., Cherry Studio preview mentioned).","Resolution (width/height) must align with spatial_patch_size (README shows divisibility requirement).","Batch generation (repeat/batch_size) increases compute and may trigger timeouts if models are cold-starting."]}}