{"_id":"@aianimate/mcp","name":"@aianimate/mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@aianimate/mcp","version":"0.1.0","description":"AiAnimate Developer API MCP server","type":"module","private":false,"repository":{"type":"git","url":"git+https://github.com/liushafeiniao/aianimate.git","directory":"packages/mcp"},"homepage":"https://github.com/liushafeiniao/aianimate/tree/main/packages/mcp#readme","bugs":{"url":"https://github.com/liushafeiniao/aianimate/issues"},"keywords":["aianimate","ai","game-assets","mcp"],"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"bin":{"aianimate-mcp":"dist/server.js"},"engines":{"node":">=20"},"scripts":{"build":"tsc -p tsconfig.build.json","type-check":"tsc --noEmit","test":"vitest run","pack:check":"npm pack --dry-run --json","prepack":"npm run build","prepublishOnly":"node -e \"console.error('禁止从包目录直接发布：prepublishOnly 仅防误操作。npm publish package.tgz 或 --ignore-scripts 可绕过它；真实发布只能由受保护 CI 的 npm Trusted Publishing 执行。'); process.exit(1)\""},"dependencies":{"@modelcontextprotocol/sdk":"^1.17.3","zod":"^3.24.2"},"devDependencies":{"@types/node":"^22.13.10","typescript":"^5.7.3","vitest":"^3.0.8"},"_id":"@aianimate/mcp@0.1.0","_integrity":"sha512-SmxLgeAEreVjujgaCKG8wI43ub2HlSmLpVHgLBRiYUr2mXbw8Mf6WoajrYUHyrBHEyBzj2Wh2G5ueRTnfWsrnQ==","_resolved":"D:\\work\\26.AIGameAsset\\tmp\\npm-bootstrap-publish-a480l0zw\\aianimate-mcp-0.1.0.tgz","_from":"file:D:/work/26.AIGameAsset/tmp/npm-bootstrap-publish-a480l0zw/aianimate-mcp-0.1.0.tgz","_nodeVersion":"24.15.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-SmxLgeAEreVjujgaCKG8wI43ub2HlSmLpVHgLBRiYUr2mXbw8Mf6WoajrYUHyrBHEyBzj2Wh2G5ueRTnfWsrnQ==","shasum":"85962d53f9e2f3d81b1906bccfdeee7f9ba0bbd6","tarball":"https://registry.npmjs.org/@aianimate/mcp/-/mcp-0.1.0.tgz","fileCount":18,"unpackedSize":67352,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCrdakiFOMrh3Dg7MjffEEZeXi48XQ087UzMmU4iJ7czQIgG+CmLmk0LlFMi5MKti3zG6t/7IAU9mZTVA90qUre3CM="}]},"_npmUser":{"name":"aianimate.cn","email":"AiAnime2026@163.com"},"directories":{},"maintainers":[{"name":"aianimate.cn","email":"AiAnime2026@163.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.0_1785763709821_0.08569657029622779"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-03T13:28:29.697Z","0.1.0":"2026-08-03T13:28:29.960Z","modified":"2026-08-03T13:28:30.190Z"},"maintainers":[{"name":"aianimate.cn","email":"AiAnime2026@163.com"}],"description":"AiAnimate Developer API MCP server","homepage":"https://github.com/liushafeiniao/aianimate/tree/main/packages/mcp#readme","keywords":["aianimate","ai","game-assets","mcp"],"repository":{"type":"git","url":"git+https://github.com/liushafeiniao/aianimate.git","directory":"packages/mcp"},"bugs":{"url":"https://github.com/liushafeiniao/aianimate/issues"},"readme":"# @aianimate/mcp\n\nAiAnimate Developer API stdio MCP server for Cursor, Codex, and other MCP hosts.\n\n## Quick start\n\nRequires Node.js 20 or newer. The server reads credentials from environment variables and never needs an API key in the MCP configuration file:\n\n```bash\nexport AIANIMATE_API_KEY=\"your-developer-api-key\"\nexport AIANIMATE_API_BASE_URL=\"https://aianimate.cn\"\nnpx -y @aianimate/mcp\n```\n\nUse `https://aianimate.design` for the international instance. Do not commit API keys or share them in logs. The Chinese reference below contains the Cursor and Codex configuration examples.\n\n## 中文说明\n\n面向 AiAnimate `/v1` 开发者 API 的 stdio MCP server。它只执行明确调用的 API 操作：运行任务必须同时提供 `confirm: true`、画布 `revision` 和 UUID `idempotencyKey`，不会隐式确认、启动浏览器或轮询任务。包内默认地址 `https://aianimate.cn` 对应国内实例；国际用户必须显式配置 `https://aianimate.design`。\n\n## 配置\n\n优先级为显式运行环境（如有）→ 环境变量 → `~/.aianimate/config.json`。不要把 API Key 写入项目配置或提交到仓库。\n\n```powershell\n$env:AIANIMATE_API_KEY = '在终端安全设置的开发者 API Key'\n$env:AIANIMATE_API_BASE_URL = 'https://aianimate.cn' # 国际实例显式改为 https://aianimate.design\nnpx -y @aianimate/mcp\n```\n\n本地配置文件可选：\n\n```json\n{\n  \"apiKey\": \"仅保存在本机的开发者 API Key\",\n  \"apiBaseUrl\": \"https://aianimate.cn\"\n}\n```\n\n包内默认值保持 `https://aianimate.cn`（国内实例）；国际生产接入始终显式配置 `https://aianimate.design`。\n\n## Cursor\n\n在 Cursor MCP 配置中引用环境变量，不填写真实 Key：\n\n```json\n{\n  \"mcpServers\": {\n    \"aianimate\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aianimate/mcp\"],\n      \"env\": {\n        \"AIANIMATE_API_KEY\": \"${env:AIANIMATE_API_KEY}\",\n        \"AIANIMATE_API_BASE_URL\": \"${env:AIANIMATE_API_BASE_URL}\"\n      }\n    }\n  }\n}\n```\n\n## Codex\n\n在 Codex MCP 配置中声明进程要继承的环境变量，不把 API Key 写入配置值：\n\n```toml\n[mcp_servers.aianimate]\ncommand = \"npx\"\nargs = [\"-y\", \"@aianimate/mcp\"]\nenv_vars = [\"AIANIMATE_API_KEY\", \"AIANIMATE_API_BASE_URL\"]\n```\n\n工具覆盖画布契约、能力、余额、项目、画布、卡片、连线、上传、估算、运行、任务、资产和交付包。通用卡片工具 `aianimate_cards_create` / `aianimate_cards_update` 支持 `inputs` 槽位映射与兼容字段 `sourceAsset`；`aianimate_estimate` 和 `aianimate_run` 均要求 `revision`，并可传递 `operation`。\n\n另提供固定卡片类型的快捷工具：`aianimate_text_*`、`aianimate_image_*`、`aianimate_video_*`、`aianimate_animation_*`、`aianimate_vfx_*`、`aianimate_package_*`，每组都包含 `create`、`estimate`、`run`，底层仍调用统一 cards 路由。所有 `*_run` 都强制 `confirm: true` 和 UUID `idempotencyKey`，从不自动轮询；例如文本 `operation: \"optimize\"` 返回 `taskId: null` 时会直接把结果返回给调用者。\n\n下载仅写入工具调用中明确指定的目标路径；来自异源签名下载地址的请求不会转发 API Key。\n","readmeFilename":"README.md","_rev":"1-8f0b5d2ca0a955de4c9a55a72df1ef4e"}