{"_id":"@mseep/replicate-flux-mcp","name":"@mseep/replicate-flux-mcp","dist-tags":{"latest":"0.4.0"},"versions":{"0.4.0":{"name":"@mseep/replicate-flux-mcp","version":"0.4.0","type":"module","bin":{"replicate-flux-mcp":"build/index.js"},"scripts":{"build":"tsc && shx chmod +x build/*.js","prepare":"npm run build","watch":"tsc --watch","inspector":"npx @modelcontextprotocol/inspector build/index.js -e REPLICATE_API_TOKEN=YOUR_REPLICATE_API_TOKEN"},"homepage":"https://github.com/awkoy/replicate-flux-mcp","keywords":["replicate","flux","mcp","flux-schnell","flux-schnell-mcp","modelcontextprotocol","image-generation","ai","mseep","mcp-server"],"author":{"name":"Yaroslav Boiko","email":"y.boikodeveloper@gmail.com"},"license":"MIT","description":"MCP for Replicate Flux Model","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","replicate":"^1.4.0","zod":"^3.25.0"},"devDependencies":{"@types/node":"^22.13.10","shx":"^0.3.4","typescript":"^5.8.2"},"engines":{"node":">=18"},"repository":{"type":"git","url":"git+https://github.com/awkoy/replicate-flux-mcp.git"},"publisher":"mseep","_id":"@mseep/replicate-flux-mcp@0.4.0","gitHead":"7c44f706d5b0f38a54c5a9d92855b3b192cb4cbe","bugs":{"url":"https://github.com/awkoy/replicate-flux-mcp/issues"},"_nodeVersion":"18.20.8","_npmVersion":"10.8.2","dist":{"integrity":"sha512-tTlEOYdnF/xTDzjWuVbQDvc/Sew9M0QdR6W8mCQ1j2shg1YnKu47df6L7YpUMa/ylraRJLGOsS2rM6fAZd4gxg==","shasum":"98d1d92eee94695fa8e0c571a309cc2803947b34","tarball":"https://registry.npmjs.org/@mseep/replicate-flux-mcp/-/replicate-flux-mcp-0.4.0.tgz","fileCount":29,"unpackedSize":80130,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIG/CJJ2RePpoA8VLpcbAlvs1QsPRJDVh8amYd0OYh/XwAiEAkR5imKfbJ6ijI1GOTCH+9pogIKLvaH1mPBi3QbWuRyM="}]},"_npmUser":{"name":"skydeckai","email":"support@skydeck.ai"},"directories":{},"maintainers":[{"name":"skydeckai","email":"support@skydeck.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/replicate-flux-mcp_0.4.0_1782121635584_0.7502839800372962"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-22T09:47:15.425Z","0.4.0":"2026-06-22T09:47:15.731Z","modified":"2026-06-22T09:47:15.956Z"},"maintainers":[{"name":"skydeckai","email":"support@skydeck.ai"}],"description":"MCP for Replicate Flux Model","homepage":"https://github.com/awkoy/replicate-flux-mcp","keywords":["replicate","flux","mcp","flux-schnell","flux-schnell-mcp","modelcontextprotocol","image-generation","ai","mseep","mcp-server"],"repository":{"type":"git","url":"git+https://github.com/awkoy/replicate-flux-mcp.git"},"author":{"name":"Yaroslav Boiko","email":"y.boikodeveloper@gmail.com"},"bugs":{"url":"https://github.com/awkoy/replicate-flux-mcp/issues"},"license":"MIT","readme":"# Replicate Flux MCP\n\n[English](README.md) | **中文**\n\n本项目是一个 Model Context Protocol (MCP) 服务器，默认使用 `black-forest-labs/flux-schnell` 生成图片，使用 `recraft-ai/recraft-v3-svg` 生成 SVG。你可以通过环境变量覆盖默认模型，图片工具也支持通过工具参数 `model_id` 在内置白名单内按次切换模型。\n\n## 目录\n- [快速开始](#快速开始)\n- [集成方式](#集成方式)\n  - [Cursor](#cursor)\n  - [Claude Desktop](#claude-desktop)\n  - [Smithery](#smithery)\n  - [Glama.ai](#glamaai)\n  - [Codex](#codex)\n- [模型配置](#模型配置)\n- [故障排查](#故障排查)\n\n## 快速开始\n1. 在 Replicate 获取 `REPLICATE_API_TOKEN`。\n2. 任选集成方式运行 `npx -y replicate-flux-mcp`（记得传入 api token）。\n3. 通过环境变量可即时切换模型：\n   ```bash\n   REPLICATE_IMAGE_MODEL_ID=\"google/imagen-4\" \\\n   REPLICATE_SVG_MODEL_ID=\"recraft-ai/recraft-v3-svg\" \\\n   REPLICATE_API_TOKEN=你的token \\\n   npx -y replicate-flux-mcp\n   ```\n\n## 集成方式\n\n### Cursor\n`.cursor/mcp.json` 示例：\n```json\n{\n  \"mcpServers\": {\n    \"replicate-flux-mcp\": {\n      \"command\": \"env\",\n      \"args\": [\n        \"REPLICATE_API_TOKEN=你的token\",\n        \"REPLICATE_IMAGE_MODEL_ID=可选\",\n        \"REPLICATE_SVG_MODEL_ID=可选\",\n        \"npx\", \"-y\", \"replicate-flux-mcp\"\n      ]\n    }\n  }\n}\n```\n\n### Claude Desktop\n`mcp.json` 示例略，与 README.md 相同，注意设置环境变量。\n\n### Smithery / Glama.ai\n可直接在各自的服务器市场添加 `replicate-flux-mcp`，无需本地部署。\n\n### Codex\n`~/.codex/config.toml` 示例：\n```toml\n[mcp_servers.replicate]\ncommand = \"npx\"\nargs = [\"-y\", \"replicate-flux-mcp\"]\nenv = { REPLICATE_API_TOKEN = \"your-replicate-api-token\", REPLICATE_IMAGE_MODEL_ID = \"your-image-model-id\", REPLICATE_SVG_MODEL_ID = \"your-svg-model-id\" }\nstartup_timeout_sec = 30_000\n```\n不填 `REPLICATE_IMAGE_MODEL_ID` / `REPLICATE_SVG_MODEL_ID` 时会使用默认模型，启动即可使用。\n\n## 模型配置\n- 默认：图片 `black-forest-labs/flux-schnell`，SVG `recraft-ai/recraft-v3-svg`。\n- 覆盖：通过环境变量 `REPLICATE_IMAGE_MODEL_ID` / `REPLICATE_SVG_MODEL_ID` 覆盖默认模型；图片工具也可通过参数 `model_id` 按次覆盖。\n- 内置白名单：\n  - 图片生成：`black-forest-labs/flux-schnell`、`google/imagen-4`、`black-forest-labs/flux-kontext-pro`、`ideogram-ai/ideogram-v3-turbo`、`black-forest-labs/flux-1.1-pro`、`black-forest-labs/flux-dev`\n  - SVG 生成：`recraft-ai/recraft-v3-svg`\n  - 兼容工具 `run_model` 额外支持：`minimax/video-01`、`luma/reframe-video`、`topazlabs/video-upscale`、`topazlabs/image-upscale`、`szcho/codeformer`、`tencentarc/gfpgan`\n- `run_replicate_model` 可用 `REPLICATE_MODEL_ALLOWLIST` 限制可运行模型；不设置表示允许任意模型，设置为空字符串表示拒绝全部。\n\n## 故障排查\n- 认证错误：确认 `REPLICATE_API_TOKEN` 有效。\n- 超时：增大 `pollingAttempts` 或 `pollingInterval`（见 `src/config/index.ts`）。\n- 模型不可用：确认所选模型在对应白名单内，且你的 Replicate 账户有权运行该模型。\n","readmeFilename":"README.zh.md","_rev":"1-c7e68d60b144024fc6765616ef5a69a4"}