一览
要在 Cursor 中使用 Mage,请添加 Mage MCP 服务器(https://mcp.mage.space/mcp),并使用你的 Mage 账号登录。之后 Cursor 就可以用 Mango 3 生成图片,用 Cherry 2 Pro 生成视频,用 Seed Audio 生成音频,也可以调用你指定的 28 个 Mage 模型中的任意一个,按每次生成以 Gems 计费。
16
MCP 工具
28
图片、视频和音频模型
5
支持的助手
$0
连接所需
设置
如何将 Mage 连接到 Cursor
需要有 Mage 账号;访客会话无法连接应用。
一键安装
点击“将 Mage 添加到 Cursor”,即可使用公开的 OAuth 客户端 ID 安装服务器。如果已安装 Mage,请替换其现有配置。
或手动添加到 mcp.json
如需手动设置,请将以下条目添加到 ~/.cursor/mcp.json。客户端 ID 是公开的,无需密钥。
{ "mcpServers": { "mage": { "url": "https://mcp.mage.space/mcp", "auth": { "CLIENT_ID": "https://cursor.com/mcp", "scopes": [ "mage", "offline_access" ] } } } }登录并开始提问
出现提示时,使用你的 Mage 账号完成授权,然后在 Agent 模式下让 Cursor 为你的项目生成媒体内容。
试一试
在 Cursor 中使用 Mage 的提示词示例
- 为种子数据生成占位用的商品照片,并保存到 /public/products。
- 用三种风格制作应用图标,并添加到 design 文件夹。
- 为空状态页面创建一段简短的新手引导视频。
工具
助手可调用的 16 个工具
| 工具 | 功能 |
|---|---|
| list_models | 列出推荐模型及其价格、最适合的用途和取舍。 |
| get_model | 说明某个模型的字段、可选值、默认值、规则和价格。 |
| estimate_cost | 在生成开始前报价,不会扣费。 |
| create_upload | 获取用于上传本地文件的签名链接,适用于能运行命令的助手。 |
| generate | 开始生成图片、视频或音频。 |
| get_request | 等待生成完成并返回结果链接。 |
| cancel_request | 停止正在进行的生成。 |
| get_account | 显示已连接的账号及其 Gems 余额。 |
| list_characters | 列出你保存的角色及其 @handle。 |
| create_character | 根据图片保存一个私有角色,也可以附带声音。 |
| delete_character | 删除你的一个角色。 |
| list_references | 列出你保存的服装、姿势、地点、物品和声音片段。 |
| create_reference | 根据图片或音频链接保存一个私有参考。 |
| delete_reference | 删除你的一个参考。 |
| list_history | 列出你最近 30 天的生成记录,包括在应用中生成的内容。 |
| search_creations | 按画面内容、合集或日期搜索你保存的作品。 |
更多助手
Mage 适用于所有主流 AI 助手
常见问题
常见问题解答
在 Cursor 中可以用 API 密钥代替 OAuth 吗?
可以。在服务器条目中设置 URL 和 headers:{ "Authorization": "Bearer ${env:MAGE_API_KEY}" },并把密钥保存在环境变量中。
什么是 Mage MCP 服务器?
这是位于 https://mcp.mage.space/mcp 的远程 Model Context Protocol 服务器,可让 AI 助手在你的 Mage 账号上生成图片、视频和音频。它为助手提供 16 个工具,用于选择模型、报价、生成、等待结果,以及使用你保存的角色、参考图和历史记录。
使用 MCP 服务器需要 API 密钥吗?
不需要。Claude、ChatGPT、Grok、Cursor 和 Claude Code 通过 OAuth 登录 Mage 即可连接。API 密钥是可选的,适用于 CI 等无界面环境。
费用是多少?
连接是免费的。助手发起的每次生成,都会按模型的标价从你的 Mage 账号中扣除 Gems。助手在开始前可以用 estimate_cost 报出价格。
我的助手会使用哪些模型?
如果你没有指定模型,助手默认用 Mango 3 生成图片,用 Cherry 2 Pro 生成视频,用 Seed Audio 生成音频。你也可以直接说出名称,调用任何其他 Mage 模型。
连接我的 Mage 账号安全吗?
在共享任何内容之前,Mage 会显示应用的名称、网站和返回地址,每次连接都需要你确认。你可以随时在 MCP → 已连接的应用 中断开任何应用。
用 Mage 开始开发
一个账号,一份 Gems 余额,畅用所有模型。按生成量付费,用多少付多少。