imgflip-mcp

imgflip-mcp

📚 完整文档：mariokernich.github.io/imgflip-mcp

你的数据库有一个 MCP 服务，你的 Kubernetes 集群有一个，云账单有一个，工单系统有一个，还有至少十二个用来读取 PDF 的服务。都是严肃工作用的严肃服务。

但不知从什么时候起，生态系统忘了真正让工程团队运转起来的工作负载：梗图。

imgflip-mcp 填补了这一空白。它是一个用于 Imgflip 梗图生成器 API 的 Model Context Protocol 服务，让 Claude（或其他任何 MCP 客户端）可以浏览数千种梗图模板，并在对话中为它们配上文字——让你的 AI 助手变成那个总能拿出恰到好处的反应图的同事。

当然，这张梗图本身就是由 imgflip-mcp 生成的。

你： “给我做一张德雷克梗图，内容是写测试与在生产环境中测试的对比。” Claude： 🖼️ 调用 get_memes → 调用 caption_image → 把图片链接发给你

你只需要一个免费的 Imgflip 账号。Imgflip API Premium 订阅是可选的——它会解锁另外五种工具（搜索、GIF 配字、自动生成梗图、AI 梗图），除非你明确启用，否则这些工具会保持隐藏。

我到底能用它做什么？

比你想象的更多。一旦生成梗图只需一句话，它就会悄悄融入实际工作流：

• 让人真正读完的文档。 让 Claude 写好 README 章节，再配上一张恰到好处的梗图——这才是留存工程的最高境界。
• 带包袱的发布说明。 “v2.0：我们把一切都重写了”，放在一张展示迁移步骤的 Expanding Brain 梗图旁边，感觉就是不一样。
• 温和一点的代码审查。 用一张 Two Buttons 梗图回应 400 行的 PR，而不是长篇说教。传达同样的信息，伤感情的可能性却更小。
• 回顾会和站会。 输入冲刺摘要，就能得到团队应得的 This Is Fine 总结。
• 事故复盘。 在最后一页放上一张选得恰到好处的 Disaster Girl，最能体现“不追责”。
• Slack 公告。 部署冻结、值班交接、“构建又变绿了”——做成梗图，效果都能明显更好。

这些真的有必要吗？不。语法高亮也不是必需的，但我们还是走到了今天。

工具

免费工具（默认启用）

工具	描述	Imgflip 端点	要求
get_memes	列出约 100 个最受欢迎的梗图模板，并可按名称筛选	GET /get_memes	无
caption_image	为模板配上文字，并获取生成的图片 URL	POST /caption_image	免费 Imgflip 账号

这两个工具端到端覆盖了日常使用场景：找到模板、添加文字、获取图片 URL。

高级工具（可选，选择启用）

工具	描述	Imgflip 端点
search_memes	按名称搜索 100 万多个模板	POST /search_memes
get_meme	按 ID 查询单个模板	POST /get_meme
caption_gif	为动画 GIF 模板添加文字	POST /caption_gif
automeme	根据一段文字自动选择模板	POST /automeme
ai_meme	让 Imgflip 的 AI 创作完整的 meme	POST /ai_meme

这些工具需要 Imgflip API Premium 订阅，且默认不会注册，因此免费层级的用户不会看到无法使用的工具。如果你拥有 Premium，请设置 IMGFLIP_PREMIUM=true 以启用这些工具。

其他功能

• 内嵌图片： 每个生成 meme 的工具都会同时以 URL 和嵌入图片的形式返回结果（最大 2 MB），因此 Claude Desktop 等客户端可以直接在聊天中呈现 meme。
• make-meme 提示词： 一个 MCP 提示词，可引导模型选择模板并添加文字——传入 topic，还可以选择性地指定 template 偏好。
• 工具注解： 查询工具标记为 readOnlyHint，客户端可据此安全地自动批准这些工具。

前置条件

• Node.js 22+
• 一个 Imgflip 账户（免费注册）——除 get_memes 外，所有工具都需要账户

环境变量

变量	必需	描述
IMGFLIP_USERNAME	是*	你的 Imgflip 用户名
IMGFLIP_PASSWORD	是*	你的 Imgflip 密码
IMGFLIP_PREMIUM	否	设置为 true 以同时注册五个 Premium 工具（默认：关闭）

* 无需凭据即可使用的只有 get_memes。

注意： Imgflip API 使用用户名/密码表单字段进行身份验证，不提供 API 密钥。建议为 API 使用专门创建一个 Imgflip 账户。

安装

该服务通过 stdio 通信，因此 MCP 客户端会将其作为子进程启动——无需管理端口或守护进程。选择适合你客户端的方式：

方式	最适合	操作方法
桌面扩展（.mcpb）	Claude Desktop	从 Releases 下载，双击，然后填写凭据表单——指南
Claude Code 插件	Claude Code	/plugin marketplace add mariokernich/imgflip-mcp，然后运行 /plugin install imgflip@imgflip-mcp——指南
VS Code 按钮	Copilot 用户	点击上方的 Install in VS Code 徽章——指南
npx	其他任意客户端	命令 npx，参数 ["-y", "imgflip-mcp"]——指南

所有客户端使用相同的配置格式。例如，在 Claude Desktop 的 claude_desktop_config.json 或 Cursor 的 .cursor/mcp.json 中：

{
  "mcpServers": {
    "imgflip": {
      "command": "npx",
      "args": ["-y", "imgflip-mcp"],
      "env": {
        "IMGFLIP_USERNAME": "your-username",
        "IMGFLIP_PASSWORD": "your-password"
      }
    }
  }
}

或者，在 Claude Code 中使用一行命令：

claude mcp add imgflip \
  --env IMGFLIP_USERNAME=your-username \
  --env IMGFLIP_PASSWORD=your-password \
  -- npx -y imgflip-mcp

如果你拥有 API Premium，请将 IMGFLIP_PREMIUM=true 添加到环境变量中。然后只需提出请求：

“制作一张 Drake meme：上方写‘手动格式化代码’，下方写‘让代码检查工具来做’。”

文档

基础内容之外的一切都在**文档站点**中：

• 快速入门 — 五分钟内从零开始制作第一个梗图
• 制作梗图 — 两步工作流、多文本框模板、定位、颜色和字体
• 工具参考 — 所有工具、参数和响应
• 配置和高级工具
• 常见问题与故障排除 — 凭据缺失、链接没有图片、工具未显示，……
• 本地开发、架构和发布

隐私

此服务在本地运行且无状态：你的 Imgflip 凭据和梗图文本只会发送到 https://api.imgflip.com（该 API 需要这些信息进行身份验证和生成），不会记录、存储或发送到其他任何地方。生成的梗图会公开托管在 imgflip.com 上。详情请见 PRIVACY.md；Imgflip 自身的数据处理方式请参阅 Imgflip 隐私政策。

贡献

欢迎贡献 — 请参阅 CONTRIBUTING.md 了解指南，并查看 CHANGELOG.md 了解发布历史。遇到问题？提交 issue — 最好附上失败的工具调用和你使用的客户端。

这是一个独立的社区项目，与 Imgflip 无关联。

许可证

MIT