通过 SpicyAPI 的官方 MCP 服务器,让 Claude Code(及 Cursor/VS Code)等 MCP 客户端统一访问 200+ 生成模型,支持询价和费用确认后再执行。
大多数图像和视频模型都各自绑定了独立的账户、SDK 和结算页面,而且大多数托管 API 还会在模型之上再叠一层审核过滤。如果你想让编程 Agent 在工作时生成一张产品图、一段短视频或一段配音,手动接入每个提供商很快就会让人厌倦,而请求被一个你根本没要求过的过滤器拒绝则更让人厌倦。
这篇文章演示了如何为 Claude Code(或 Cursor、Codex、VS Code 及其他 MCP 客户端)提供一个统一的工具,能够浏览 200 多个生成模型、查询价格并执行任务,且在产生任何费用前 Agent 会先停下来征得你的同意。它使用的是 SpicyAPI——一个无限制的 AI API——的官方 MCP 服务器:该平台本身不添加任何内容过滤器,你能生成什么内容完全取决于你选择的模型,且目录中标注了哪些模型是未经审查的。
需要 Node.js 22.13 或更高版本(运行 node --version 查看版本)。
一个 SpicyAPI API 密钥。在 API 密钥页面创建一个。密钥以 sk-spicy- 开头,且只显示一次。在"高级"设置中,你可以为密钥设置每日限额或限制其只能调用特定模型——对于 Agent 使用的密钥来说,这些限制措施很有必要。
账户中需要有资金用于付费任务。浏览模型、查询价格和读取结果都是免费的。
在你将运行命令的终端中导出密钥,然后注册服务器:
export SPICY_API_KEY="sk-spicy-..."
claude mcp add spicyapi \
-e SPICY_API_KEY=$SPICY_API_KEY \
-- npx --yes --package=@spicyapi/mcp spicyapi-mcp
--package 参数很关键:该包发布了两个二进制文件,所以直接运行 npx @spicyapi/mcp 无法确定该用哪一个。
用 claude mcp list 或会话内的 /mcp 检查是否添加成功。如果希望每个项目都能用,加上 --scope user;避免使用 --scope project,否则会把你的密钥写入仓库里的 .mcp.json。
Cursor 读取 ~/.cursor/mcp.json(Windsurf 和 Gemini CLI 在各自的文件中使用相同的格式):
{
"mcpServers": {
"spicyapi": {
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
"env": { "SPICY_API_KEY": "YOUR_SPICY_API_KEY" }
}
}
}
把这个配置放在用户级文件中,而不是会被提交到仓库的项目文件里。
"Check the SpicyAPI service status." 这个工具不需要密钥,所以能验证服务器是否正常启动。
"What is my SpicyAPI balance?" 验证密钥能否正确连接到服务器。
"Which SpicyAPI tools do you have?" 你应该看到 15 个以 spicyapi_ 为前缀的工具。
"Use SpicyAPI to list the image models I can call, pick an inexpensive one, generate a cinematic night portrait, and give me the result link when it finishes."
在后台,Agent 会:
读取实时目录和所选模型的输入规范;
获取精确的 USD 报价;
停下来让你确认预估费用和最高扣费限额;
创建任务、等待完成并返回结果链接。
还有几个效果不错的用法:
"Find models that turn an image into a video and compare what a 5-second clip costs on each."(浏览目录加查询报价,免费)
"Turn ~/Desktop/product.jpg into a 5-second video with a slow push-in."(上传文件,然后执行确认后的任务)
"Show my tasks from the last three days that failed, and why."
付费工具使用 MCP elicitation 机制:确认界面由你的客户端渲染,答案也由你给出,而不是由模型决定。回答与具体请求绑定,所以如果提问后模型或输入有变化,则不会创建任何任务。拒绝意味着不会产生任务、不会扣款、也不会冻结资金。报价有效期为五分钟,不支持 elicitation 的客户端根本无法创建付费任务,只读工具仍然可用。
spicyapi_upload_file 接收绝对路径,上传文件后返回 spicy:// URI 供 Agent 传递给模型。默认情况下只读取主目录下的文件,这能保护你免受通过网页或邮件植入的路径攻击。结果会作为可直接使用的链接返回;生成的文件保留约 14 天,所以要保留的内容记得自行下载。
网站和模型目录:spicyapi.ai
完整 MCP 指南:docs.spicyapi.ai/docs/mcp
源代码:github.com/spicyapi-ai/spicy-mcp
如果你还希望 Agent 了解推荐的工作流程,可以使用 Agent Skill:npx skills add spicyapi-ai/spicy-skill