{
  "markdown": "# ShotFlow MCP Server\n\n> 让 AI Agent 直接调用专业分镜脚本生成能力\n\n[![MCP Version](https://img.shields.io/badge/MCP-1.0-blue)](https://modelcontextprotocol.io)\n[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)\n[![Online](https://img.shields.io/badge/status-Online-brightgreen)](https://aishotflow.cn/mcp/health)\n\nShotFlow MCP Server 是 [ShotFlow](https://aishotflow.cn) 的 Model Context Protocol 接口实现，让任何支持 MCP 的 AI 客户端（Claude Desktop、Cursor、Cline、VS Code Copilot 等）都能直接调用专业分镜脚本与视频生成能力。\n\n---\n\n## 在线使用\n\n**无需安装，直接配置 URL 即可使用：**\n\n```\nhttps://aishotflow.cn/mcp\n```\n\n---\n\n## 功能一览\n\n| Tool | 说明 |\n|------|------|\n| `generate_storyboard` | 从剧本/创意描述生成专业分镜脚本（6种创作类型 × 7种视觉风格） |\n| `generate_video` | 从分镜镜头生成视频（Pro 功能） |\n| `check_video_status` | 查询视频生成状态 |\n| `regenerate_shot` | 单镜头重新生成 |\n| `list_video_tasks` | 列出视频任务历史 |\n| `check_quota` | 查询今日配额 |\n| `check_health` | 检查服务健康状态 |\n\n| Resource | 说明 |\n|----------|------|\n| `shotflow://templates/creative-types` | 6种创作类型模板与默认参数 |\n| `shotflow://templates/visual-styles` | 7种视觉风格参考与关键词 |\n\n---\n\n## 快速接入\n\n### Claude Desktop\n\n编辑配置文件（macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`，Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`）：\n\n```json\n{\n  \"mcpServers\": {\n    \"shotflow\": {\n      \"url\": \"https://aishotflow.cn/mcp\"\n    }\n  }\n}\n```\n\n重启 Claude Desktop，点击「Attached tools」确认 `shotflow` 已加载。\n\n### Cursor IDE\n\n在项目根目录创建 `.cursor/mcp.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"shotflow\": {\n      \"url\": \"https://aishotflow.cn/mcp\"\n    }\n  }\n}\n```\n\n### VS Code（1.99+）\n\n在项目根目录创建 `.vscode/mcp.json`：\n\n```json\n{\n  \"servers\": {\n    \"shotflow\": {\n      \"type\": \"http\",\n      \"url\": \"https://aishotflow.cn/mcp\"\n    }\n  }\n}\n```\n\n### Cline / Roo-Cline\n\n编辑 `~/.cline/mcp_settings.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"shotflow\": {\n      \"url\": \"https://aishotflow.cn/mcp\"\n    }\n  }\n}\n```\n\n---\n\n## 调用示例\n\n### 生成短视频分镜\n\n告诉你的 AI 客户端：\n\n> 用 shotflow 的 generate_storyboard 工具，帮我生成一个短视频分镜：一个创业者熬夜做产品的故事，3个场景，温情风格，9:16竖屏\n\nAI 会自动调用 MCP Tool，返回结构化分镜结果。\n\n### 查看可用创作类型\n\n> 读取 shotflow 的 creative-types 资源，告诉我有哪些创作类型可选\n\n---\n\n## Agent Card（A2A 协议）\n\n其他 AI Agent 可通过以下 URL 自动发现 ShotFlow 的能力：\n\n```\nhttps://aishotflow.cn/mcp/agent-card\n```\n\n---\n\n## 部署自己的实例\n\n### 要求\n\n- Node.js 18+\n- ShotFlow Express Server 运行在 `localhost:3003`\n\n### 安装\n\n```bash\ngit clone https://github.com/YOUR_USERNAME/shotflow-mcp.git\ncd shotflow-mcp\n# 无需 npm install，零依赖\n```\n\n### 启动\n\n```bash\n# 开发模式\nnode shotflow-mcp-server.js\n# 默认端口 3004\n\n# 生产部署（systemd）\nsudo cp shotflow-mcp.service /etc/systemd/system/\nsudo systemctl enable shotflow-mcp\nsudo systemctl start shotflow-mcp\n```\n\n### 环境变量\n\n| 变量 | 默认值 | 说明 |\n|------|--------|------|\n| `MCP_PORT` | `3004` | MCP Server 监听端口 |\n| `SHOTFLOW_API_URL` | `http://localhost:3003` | ShotFlow Express 地址 |\n| `NODE_ENV` | `development` | 环境模式 |\n\n---\n\n## 架构\n\n```\nAI Client (Claude/Cursor/...)\n    ↓ Streamable HTTP (JSON-RPC 2.0)\nNginx :443\n    └── /mcp → ShotFlow MCP Server :3004\n                    └── HTTP → ShotFlow Express :3003\n```\n\n- **协议**: MCP 1.0（Streamable HTTP + SSE）\n- **传输**: JSON-RPC 2.0 over HTTP\n- **依赖**: 零外部依赖（纯 Node.js 实现）\n- **SSE 支持**: `proxy_buffering off` 配合 Nginx 实现流式进度推送\n\n---\n\n## 文件结构\n\n```\nshotflow-mcp/\n├── shotflow-mcp-server.js   # MCP Server 主文件\n├── tool-definitions.js       # 7个 Tool 的 JSON Schema 定义\n├── resource-definitions.js   # 2个 Resource 定义\n├── prompt-builder.js        # Prompt 构造与模型配置解析\n├── package.json             # npm 包配置\n├── shotflow-mcp.service     # systemd 服务文件\n├── INTEGRATION.md          # 详细接入文档\n├── README.md               # 本文件\n└── test/\n    └── test-mcp.js        # 测试套件\n```\n\n---\n\n## 测试\n\n```bash\n# 启动本地服务\nnode shotflow-mcp-server.js &\n\n# 运行测试\nnode test/test-mcp.js\n```\n\n---\n\n## 相关链接\n\n- **ShotFlow 主站**: https://aishotflow.cn\n- **MCP 端点**: https://aishotflow.cn/mcp\n- **Agent Card**: https://aishotflow.cn/mcp/agent-card\n- **MCP 协议规范**: https://modelcontextprotocol.io\n- **ShotFlow 公众号**: 扫码关注获取最新更新\n\n---\n\n## 许可证\n\nMIT License — 自由使用、修改和分发。\n\n---\n\n## 支持\n\n- GitHub Issues: https://github.com/YOUR_USERNAME/shotflow-mcp/issues\n- 邮件: admin@aishotflow.cn\n",
  "bytes": 4044,
  "sha": "c4a13fcb72ea74500ab9e3571fc03f6c7982725188b4c16b00727cd15b0ddde0",
  "repo_slug": "johnzhang-ui/shotflow-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_johnzhang_ui_shotflow_mcp_504b6290/readme"
}