markitup-mcp-server

markitup-mcp-server

适用于 MarkItUp 的 MCP（Model Context Protocol）服务，可用于 AI 驱动的图像标注和营销视觉素材生成。让 Claude Code、Claude Desktop、Cursor、支持 MCP 的 ChatGPT 及其他兼容 MCP 的客户端能够直接调用 MarkItUp。

提供五种工具：markitup_credit_balance、markitup_generate、markitup_regen、markitup_extend、markitup_remove_background。

前置条件

1. MarkItUp 账号——在 https://markitup.app 注册。
2. MarkItUp API 密钥——在 https://markitup.app/dashboard 生成。
3. Node.js 18 或更高版本（仅在本地安装时需要；如果 MCP 客户端自带 Node.js，则使用 npx 无需本地安装 Node.js）。

在 Claude Code 中配置

将以下内容添加到 MCP 配置文件（~/.claude/mcp.json 或项目范围的 .mcp.json）：

{
  "mcpServers": {
    "markitup": {
      "command": "npx",
      "args": ["-y", "markitup-mcp-server"],
      "env": {
        "MARKITUP_API_KEY": "mk_live_..."
      }
    }
  }
}

在 Claude Desktop 中配置

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "markitup": {
      "command": "npx",
      "args": ["-y", "markitup-mcp-server"],
      "env": {
        "MARKITUP_API_KEY": "mk_live_..."
      }
    }
  }
}

在 Cursor 中配置

Cursor 使用相同的 JSON 格式。依次选择“Settings”→“MCP”→“Add Server”：

{
  "mcpServers": {
    "markitup": {
      "command": "npx",
      "args": ["-y", "markitup-mcp-server"],
      "env": { "MARKITUP_API_KEY": "mk_live_..." }
    }
  }
}

工具

markitup_credit_balance

返回当前余额和订阅状态。

不需要参数。可用于验证 API 密钥是否有效，以及在调用生成工具前检查额度。

markitup_generate

根据截图生成 3 种精美的营销视觉素材。消耗 1 个额度。

参数	类型	必填	描述
description	string	是	描述图像内容以及需要突出显示的内容
template_id	string	是	可选 glassmorphic、clean_minimal、bold_marketing、dark_professional、documentation 等模板之一
image_url	string	二选一	源图像的公开 HTTPS URL
image_base64	string	二选一	以 Base64 编码的图像字节（不含 data: 前缀）
image_mime_type	string	否	提供 image_base64 时使用的 MIME 类型。默认值：image/png
aspect_ratio	string	否	可选 1:1、3:2、2:3、3:4、4:3、4:5、5:4、9:16、16:9、21:9 之一
image_size	string	否	1K、2K 或 4K

返回：营销文案（标题、副标题）以及 3 种生成的图像变体，均以 Base64 图像内容块的形式提供。完整的结构化响应也可通过 structuredContent 获取。

提示词示例（在 Claude Code 中）：

使用 markitup_generate 处理 https://example.com/dashboard.png 上的截图——突出显示导出按钮，并使用 bold_marketing 模板将其用于营销落地页宣传。

markitup_regen

根据先前 markitup_generate 调用的结果重新生成一种变体。默认消耗 1 个额度（设置 charge_credit: false 可跳过扣费）。

LLM 必须传回先前生成结果 structuredContent.text 中的 text_analysis 对象，以确保重新生成的视觉素材保持相同的品牌风格和标题／副标题。variation_index 用于选择对应位置（0–2）。

markitup_extend

AI 扩图——将图像扩展到更大的画布／不同的宽高比。消耗 1 个额度。

参数	类型	必填	描述
image_url / image_base64	string	二选一	源图像
aspect_ratio	string	是	目标比例（16:9、9:16 等）
target_width / target_height	number	是	输出像素尺寸
image_size	string	否	1K、2K 或 4K

markitup_remove_background

通过 Photoroom 的 HD 模型移除图像背景。返回透明 PNG。消耗 1 个点数（活跃的 Pro/Power 订阅用户可免费使用）。

参数	类型	必填	说明
image_url / image_base64	string	二选一	源图像

环境变量

变量	必填	说明
MARKITUP_API_KEY	是	从 MarkItUp 控制面板获取的 API 密钥
MARKITUP_API_BASE	否	覆盖 API 基础 URL。默认值：https://markitup.app/api/v1。适用于针对预发布环境进行测试。

本地开发

git clone https://github.com/markitup/mcp-server.git
cd mcp-server
npm install
npm run build

# Point your MCP client config at the local build:
{
  "command": "node",
  "args": ["/absolute/path/to/mcp-server/dist/index.js"],
  "env": { "MARKITUP_API_KEY": "mk_test_..." }
}

安全

• 切勿将 MARKITUP_API_KEY 提交到源代码管理中。
• 如果密钥意外泄露，请立即前往 https://markitup.app/dashboard 撤销密钥并创建新密钥。
• 服务器会对密钥进行 SHA-256 哈希处理；原始密钥仅在创建时显示一次。

错误

对于常见情况，服务器会提供清晰易懂的错误信息：

• Invalid or missing MARKITUP_API_KEY — 设置或轮换密钥。
• Out of MarkItUp credits — 前往 https://markitup.app/credits 充值。
• Rate limit exceeded — 稍等片刻后重试。

许可证

MIT