genmux MCP 服务器
一个 MCP 服务器，把 genmux 的图像能力交给助手：列出带价格的模型目录、用任意模型生成图片、取回结果、预估费用、查询余额——而你的 API 密钥始终留在自己机器上。对话和工具调用用不到它：助手本来就能直接访问兼容 OpenAI 的接口。
claude mcp add genmux -e GENMUX_API_KEY=nb_live_... -- npx -y @genmux/mcp安装
服务器就是 npm 包 @genmux/mcp，通过 stdio 通信。任何 MCP 客户端都可以用 npx 启动它，唯一必填的配置是密钥。
export GENMUX_API_KEY=nb_live_...
npx -y @genmux/mcp环境变量
| GENMUX_API_KEY | 必填——控制台里创建的 API 密钥 |
| GENMUX_API_BASE | 选填——默认 https://api.genmux.tech/v1 |
| GENMUX_OUTPUT_DIR | 选填——保存图片的目录，默认 ./genmux-images |
服务器提供什么
六个工具、若干助手可自行读取的资源，以及两个把模糊需求变成正确调用的提示模板。
工具
list_models- 模型目录，可按 kind（image 或 text）过滤，带实时价格。
generate_image- 用指定模型生成：提示词、分辨率、比例、n、反向提示词、参考图；可选择把文件保存到本地。
get_generation- 按 id 取回任务——状态、带新下载链接的图片、费用。
list_generations- 账户最近的任务，最新的在前。
account_balance- 积分余额和在途任务数。
estimate_cost- 在真正发起请求前，先算出这次调用要花多少。
资源
genmux://docs/llms.txtgenmux://docs/openapi.yamlgenmux://modelsgenmux://snippets/{python,node,curl,openai-sdk}
以 llms.txt 形式提供的 API 参考、OpenAPI 文档、模型列表，以及 Python、Node、curl 和 OpenAI SDK 的现成代码片段——助手不用离开编辑器就能把 genmux 接进你的代码。
提示模板
integrate-genmux- 带着助手把 genmux 接入一个代码库：密钥、base URL、各个接口和计费规则。
pick-a-model- 根据实时目录里的价格和能力，为你描述的任务挑一个模型。
这里刻意没有 chat 工具：助手本来就会自己调用对话接口，在模型内部再套一层调用模型的工具只会多一跳。
添加到你的客户端
各处都是同一条 npx 命令，区别只在客户端读取哪个文件。把 nb_live_... 换成你自己的密钥。
Claude Desktop 与 Claude Code
Claude Code 一条命令就能注册服务器；Claude Desktop 在它的 MCP 设置里填同样的 command/args/env 块。
claude mcp add genmux -e GENMUX_API_KEY=nb_live_... -- npx -y @genmux/mcpCursor
在项目里放一个 .cursor/mcp.json（或写进全局 MCP 设置），使用标准的 mcpServers 块。
{
"mcpServers": {
"genmux": {
"command": "npx",
"args": ["-y", "@genmux/mcp"],
"env": { "GENMUX_API_KEY": "nb_live_..." }
}
}
}OpenCode
OpenCode 在 opencode.json 里与 providers 并列声明 MCP 服务器——就是编程智能体页面里配置对话模型的同一个文件。
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"genmux": {
"type": "local",
"command": ["npx", "-y", "@genmux/mcp"],
"environment": { "GENMUX_API_KEY": "nb_live_..." }
}
}
}Continue
Continue 在 config.yaml 里列出 MCP 服务器；之后助手在 agent 模式下就能看到这些工具。
mcpServers:
- name: genmux
command: npx
args: ["-y", "@genmux/mcp"]
env:
GENMUX_API_KEY: nb_live_...托管接入点
对于更希望使用远程服务器的客户端（Claude 自定义连接器、Cursor 的 URL 服务器），同一个服务器以 Streamable HTTP 形式运行在 mcp.genmux.tech。用密钥作为 bearer token 认证。
{
"mcpServers": {
"genmux": {
"url": "https://mcp.genmux.tech/mcp",
"headers": { "Authorization": "Bearer nb_live_..." }
}
}
}密钥存放在哪里
用 npx 时服务器跑在你自己的机器上，从环境变量读取 GENMUX_API_KEY：密钥不会离开该进程，助手只看得到工具返回的结果。你要求保存时，图片会写入 GENMUX_OUTPUT_DIR。
托管接入点在每个请求的 Authorization: Bearer 头里通过 TLS 传输密钥；除了 API 本来就会保留的生成记录之外，服务端不额外存储任何内容。
请用一把你能接受其消费额度的专用密钥——密钥可在控制台创建、轮换和吊销，每把还能配置 IP 白名单。
常见问题
- genmux MCP 服务器是做什么的？
- 它让支持 MCP 的助手——Claude Desktop、Claude Code、Cursor、OpenCode、Continue——能用 genmux 生成图片，并查询模型、价格、任务和余额。助手负责调用工具；你像对待其他 MCP 服务器一样逐次批准。
- 怎么安装？
- 设置好环境变量 GENMUX_API_KEY 后运行 npx -y @genmux/mcp。Claude Code：claude mcp add genmux -e GENMUX_API_KEY=nb_live_... -- npx -y @genmux/mcp。其他客户端在各自的 MCP 配置文件里填同样的 command、args 和 env；上面的代码片段给出了每一种。
- 有托管版本吗？
- 有：https://mcp.genmux.tech/mcp 使用 Streamable HTTP，通过 Authorization: Bearer <你的密钥> 认证。只接受 URL 的客户端（例如 Claude 自定义连接器）用它；希望密钥留在本机、图片保存到本地时用 npx。
- 它提供哪些工具？
- list_models、generate_image、get_generation、list_generations、account_balance 和 estimate_cost，另外还有资源（llms.txt 参考、OpenAPI 文档、模型列表和代码片段）以及两个提示模板 integrate-genmux 和 pick-a-model。
- 能通过它和 DeepSeek 或 Qwen 对话吗？
- 通过 MCP 服务器不行——这是刻意的。对话模型走兼容 OpenAI 的接口，每个助手和编程智能体本来就原生支持它并带工具调用；配置见编程智能体页面。
- 要花多少钱？
- 服务器本身免费；每次 generate_image 调用与普通 API 请求一样计费——就是模型页面上标示的每张积分，任务失败则退回。estimate_cost 让你在调用前知道数字，account_balance 告诉你还剩多少。
- 生成的图片放在哪里？
- API 返回有效期 15 分钟的下载链接，工具结果里就带着它们。传 save: true（或直接让助手保存），服务器会把文件写入 GENMUX_OUTPUT_DIR，默认是 ./genmux-images。
- 助手能看到我的 API 密钥吗？
- 不能。用 npx 时密钥由服务器进程从环境变量读取；用托管接入点时它走你客户端发送的 Authorization 头。两种情况下它都不会出现在对话里。