xhs-image-mcp

XHS Image MCP

将文章/文本转换为小红书风格图片卡片的 MCP Server，支持 AI 生成封面图。

功能

• 智能分页 - 使用浏览器实际测量自动分页，确保内容不溢出
• 4种主题 - minimal / elegant / warm / dark
• 3种比例 - 3:4 (推荐) / 1:1 / 4:3
• AI 封面 - 使用 Gemini 根据文章内容生成艺术封面（设置 API Key 后自动启用）
• Markdown 支持 - 直接读取 .md 文件并自动清理格式
• MCP 协议 - 可与 Claude Desktop / Claude Code 集成

v1.1.0 更新

• ✨ 智能 AI 封面 - 设置 GEMINI_API_KEY 后自动生成 AI 封面，无需手动开启
• 🔧 自动分页优化 - 使用浏览器实际测量替代字数估算，彻底解决内容溢出问题
• 📐 AI 封面空间适配 - 第一页自动为 AI 封面横幅预留空间

小红书尺寸

| 比例 | 尺寸 | 说明 | |------|------|------| | 3:4 | 1080×1440px | 推荐，占据最大屏幕空间 | | 1:1 | 1080×1080px | 方形，适合产品展示 | | 4:3 | 1080×810px | 横版，适合风景照 |

安装

npm install -g xhs-image-mcp
npx playwright install chromium

或从源码安装：

git clone https://github.com/dthinkr/xhs-image-mcp.git
cd xhs-image-mcp
npm install
npx playwright install chromium
npm run build

使用

MCP Server 配置

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "xhs-image": {
      "command": "npx",
      "args": ["-y", "xhs-image-mcp"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "xhs-image": {
      "command": "npx",
      "args": ["-y", "xhs-image-mcp"]
    }
  }
}

测试

npm test

MCP Tools

text_to_images

将文本转换为图片序列。

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | text | string | Yes | 文本内容 | | title | string | | 标题（用于封面） | | theme | string | | minimal / elegant / warm / dark | | ratio | string | | 3:4 / 1:1 / 4:3 | | fontSize | string | | small / medium / large | | showCover | boolean | | 是否生成封面页 | | generateAiCover | boolean | | 使用 AI 生成封面图（设置 API Key 后默认开启，传 false 可禁用） | | outputDir | string | | 输出目录，图片保存为 PNG |

file_to_images

将 Markdown/文本文件转换为图片。

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | filePath | string | Yes | 文件路径 (.md/.txt) | | title | string | | 覆盖自动提取的标题 | | theme | string | | 主题 | | generateAiCover | boolean | | AI 封面（设置 API Key 后默认开启，传 false 可禁用） | | outputDir | string | | 输出目录 |

estimate_pages

估算页数（不生成图片）。

list_themes

列出所有可用主题。

主题

| 主题 | 风格 | 适用场景 | |------|------|----------| | minimal | 白底黑字，简约 | 知识干货、教程 | | elegant | 米白衬线，书卷气 | 小说、散文、诗歌 | | warm | 暖色渐变，卡片式 | 情感生活、分享 | | dark | 深色护眼 | 夜间阅读、科技 |

环境变量

| 变量 | 说明 | |------|------| | GEMINI_API_KEY | Google Gemini API Key，用于 AI 封面生成（设置后自动启用 AI 封面） |

获取 API Key: https://aistudio.google.com/app/apikey

License

MIT