项目简介

Imgflip Meme Creator MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端,它扩展了大型语言模型(LLM)的能力,使其可以创建和分享网络迷因。通过集成 Imgflip API,该服务器提供了一系列工具,允许 LLM 搜索迷因模板、获取模板信息以及生成带有自定义文本的迷因图片。

主要功能点

  • 迷因搜索: 通过关键词搜索 Imgflip 上的迷因模板。
  • 模板信息: 获取特定迷因模板的详细信息,例如所需文本框的数量。
  • 迷因创建: 使用指定的模板和自定义文本生成迷因图片。
  • 概念迷因: 根据用户提供的概念描述,智能搜索合适的迷因模板并生成迷因。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/redblock-ai/imgflip-mcp.git
    cd imgflip-mcp
  2. 安装依赖: 确保已安装 'uv' (参考 https://docs.astral.sh/uv/getting-started/installation/),然后运行:

    uv sync --dev --all-extras
  3. 配置 Imgflip API 凭据: 在项目根目录下创建 '.env' 文件,并添加您的 Imgflip API 用户名和密码:

    IMGFLIP_USERNAME="YOUR_IMGFLIP_USERNAME"
    IMGFLIP_PASSWORD="YOUR_IMGFLIP_PASSWORD"

    如果您没有 Imgflip API 账号,需要在 Imgflip 官网注册并获取 API 凭据。

服务器配置

要将此 MCP 服务器与 MCP 客户端(例如 Claude)集成,您需要配置客户端的服务器设置。以下是一些配置示例,您需要根据您的实际环境选择合适的配置,并将 '<PATH_TO_PROJECT_DIR>' 替换为 'imgflip-mcp' 项目的绝对路径。

开发/未发布服务器配置 (本地运行):

"mcpServers": {
  "imgflip-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "<PATH_TO_PROJECT_DIR>",
      "run",
      "imgflip-mcp"
    ]
  }
}

参数注释:

  • 'command': 运行服务器的命令,这里使用 'uv'。
  • 'args': 命令参数列表。
    • '--directory': 指定项目目录。
    • '<PATH_TO_PROJECT_DIR>': 请替换为项目 'imgflip-mcp' 所在的实际路径。
    • 'run': 'uv run' 命令用于运行 Python 脚本。
    • 'imgflip-mcp': 指定要运行的脚本入口,对应 'src/imgflip_mcp/init.py' 中定义的 'main' 函数。

发布服务器配置 (已打包发布):

如果服务器已打包并可通过 'uvx' 运行,可以使用以下配置:

"mcpServers": {
  "imgflip-mcp": {
    "command": "uvx",
    "args": [
      "imgflip-mcp"
    ]
  }
}

参数注释:

  • 'command': 运行已发布服务器的命令,这里使用 'uvx'。
  • 'args': 命令参数列表。
    • 'imgflip-mcp': 服务器的包名或可执行文件名。

基本使用方法

配置完成后,您可以在 MCP 客户端中通过自然语言指令来使用迷因创建功能。例如,在 Claude 中,您可以这样指示:

Create a meme using the "Drake" template with "Writing code" and "Making memes" as text.

或者更简洁地:

Make a meme about debugging code for hours only to find a simple typo.

客户端会将这些指令转换为对 MCP 服务器工具的调用,例如 'imgflip_create_meme' 或 'imgflip_create_from_concept',并利用 Imgflip API 生成迷因图片。

可用工具列表:

| 工具名称 | 描述 | |--------------------------|------------------------------------------| | 'imgflip_search_memes' | 使用关键词搜索迷因模板 | | 'imgflip_get_template_info' | 获取迷因模板的详细信息,包括文本框数量 | | 'imgflip_create_meme' | 使用自定义文本创建迷因图片 | | 'imgflip_generate_search_terms'| 为迷因概念生成最佳搜索词 | | 'imgflip_create_from_concept'| 根据概念描述创建迷因,自动搜索模板和生成文字 |

信息

分类

AI与计算