GenMagic

GenMagic MCP 服务

一个模型上下文协议服务，让任何 AI Agent 都能生成文本、图像、语音、音乐和视频，费用从同一个预付余额中扣除。

GenMagic 是一个适用于各种生成式 AI 模型和各种媒介的工作室与 API。本仓库是其远程 MCP 服务的连接指南和注册表描述：让任何 MCP 客户端连接到一个 URL，填入密钥，Agent 即可使用六种生成工具和 list_models：它可以按 ID 选择 GenMagic 的 450 多种模型（GPT、Claude、Gemini、Veo、Kling、Seedance、FLUX、Recraft 等），也可以将选择交给 GenMagic。

• 端点： https://genmagic.co/api/mcp
• 传输方式： Streamable HTTP（无状态 JSON-RPC）
• 版本： 1.1.1
• 身份验证： Authorization: Bearer gm_live_...（在 https://genmagic.co/get-api-key 创建密钥）
• 托管： 无需安装或运行任何内容。这是一个实时远程服务。
• 注册表： 已列入 Official MCP Registry，名称为 io.github.yumaheymans/genmagic（参见 server.json）。

工具

工具	功能
list_models	实时模型目录，按最新顺序排列：每个模型的 ID、价格和关键详情（文本的上下文窗口和功能、语音的音色、视频的分辨率、片段时长和声音）。可按 category、search 或 capability 筛选。无需密钥。
generate_text	生成文本、代码、SVG 图形或完整网页（type 和 model 均可选）。
generate_image	生成或编辑图像；使用 type=logo 可生成品牌标识；model 可选。
generate_speech	将文本转换为语音，逐字朗读；model 和 voice 可选。
generate_music	根据描述生成原创音乐曲目；model 可选。
create_video	使用支持的任意文本转视频模型启动异步视频任务，并设置 duration、resolution 和 generate_audio（返回任务 ID，此时尚不扣费）。
get_video	轮询视频任务；任务完成时扣费。

每个生成工具都接受一个可选的 model ID，该 ID 来自 list_models。如果模型 ID 不支持生成相应类型的内容，系统会拒绝请求并提示使用 list_models，绝不会替换为其他模型；省略 model，GenMagic 会选择性价比高的默认模型。

initialize、ping、tools/list 和 list_models 均可公开使用；生成工具则需要密钥。每个工具的结果都会在 MCP _meta 键 genmagic.ai/usage 下说明费用情况（实际运行的 model、cost_cents、credits_remaining 和 rate 对象），Agent 可根据已有结果控制调用频率并跟踪预算。

连接

在 https://genmagic.co/get-api-key 创建密钥（免费注册并验证电子邮件），然后将服务添加到客户端。

Claude Code

claude mcp add --transport http genmagic https://genmagic.co/api/mcp \
  --header "Authorization: Bearer gm_live_your_key"

VS Code

一键安装：打开 https://genmagic.co/developers#mcp 并选择 添加到 VS Code；VS Code 会提示输入密钥一次，并将其作为机密保存。也可以自行将其添加到 .vscode/mcp.json：

{
  "inputs": [
    { "type": "promptString", "id": "genmagic-api-key", "description": "GenMagic API key", "password": true }
  ],
  "servers": {
    "genmagic": {
      "type": "http",
      "url": "https://genmagic.co/api/mcp",
      "headers": { "Authorization": "Bearer ${input:genmagic-api-key}" }
    }
  }
}

Cursor、Windsurf 和大多数客户端

在 MCP 配置中添加一个 genmagic 条目（.cursor/mcp.json，或客户端对应的配置文件）。Cursor 还提供一键安装选项，可在 https://genmagic.co/developers#mcp 选择 添加到 Cursor。

{
  "mcpServers": {
    "genmagic": {
      "url": "https://genmagic.co/api/mcp",
      "headers": { "Authorization": "Bearer gm_live_your_key" }
    }
  }
}

Claude Desktop

在 设置 → 连接器 中将 GenMagic 添加为自定义连接器，使用 URL https://genmagic.co/api/mcp 和标头 Authorization: Bearer gm_live_your_key。

任意 JSON-RPC 客户端（原始方式）

该服务使用纯 HTTP 传输 JSON-RPC，因此你可以通过 curl 调用：

# List the tools (no key required)
curl https://genmagic.co/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'

# Generate an image (key required)
curl https://genmagic.co/api/mcp \
  -H "Authorization: Bearer gm_live_your_key" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0", "id": 2, "method": "tools/call",
    "params": {
      "name": "generate_image",
      "arguments": { "prompt": "a cobalt prism refracting into a spectrum, dark studio, 3D render", "size": "1024x1024" }
    }
  }'

计费方式

不设单独的 Agent 计量。无论是通过工作室、REST API 还是此 MCP 服务进行生成，都会从同一个预付美元余额中扣除底层模型的实际服务商成本（1 个额度 = 1 美分）。新账户通过电子邮件验证后可一次性获得 $0.50 的新手余额，每人限领一次；可按 $5 至 $100 的额度充值，也可订阅以获得可续充余额、订阅者奖励和商业使用权。create_video 和仍在渲染中的 get_video 轮询均不收费；视频片段的费用会在完成生成的那次轮询中扣除。详见 https://genmagic.co/pricing。

品牌一致性生成

在应用中开启一次个性化（连接网站或 LinkedIn），之后每次工具调用都会根据你的品牌语调、受众和配色生成内容，无需修改提示词。视觉工具结果还会额外返回 brand_fit 评估，供 Agent 查看；如果生成结果偏离品牌配色，Agent 可以重新生成。

链接

• 工作室：https://genmagic.co · API 密钥：https://genmagic.co/get-api-key
• 完整 API 和 MCP 文档：https://genmagic.co/developers
• 机器可读的发现文件：/.well-known/mcp.json · /llms.txt · /openapi.json
• 定价：https://genmagic.co/pricing

许可证

MIT。详见 LICENSE。此仓库包含连接文档和注册表描述文件；GenMagic 服务本身由 genmagic.co 运营。