表情包 MCP 服务器

一个功能强大的 MCP (Model Context Protocol) 服务器，用于管理、搜索和分发本地表情包。

功能特性

• 📋 智能列表 - 快速获取所有可用表情包的名称。

• 🔍 模糊搜索 - 支持关键词匹配、模糊匹配及相似名称推荐，找不到精确匹配时也会给出建议。

• 🌐 即时访问 - 自动将本地图片转为 HTTP URL，支持在聊天软件（如 Cherry Studio）中直接预览。

• ➕ 一键添加 - 支持通过 本地路径 或 网络 URL 直接添加表情包，自动下载、重命名并归档。

• 🗑️ 便捷删除 - 支持一键从索引和磁盘中永久删除不再需要的表情包。

• 🔄 全自动管理 - 自动启动和管理后台静态资源服务器，无需人工干预。

安装步骤

1. 安装依赖

pip install -r requirements.txt

2. 准备工作

创建一个 memes 目录。你可以直接把图片丢进去，也可以通过工具动态添加。

目录结构：

meme-mcp/
├── meme_server.py
├── requirements.txt
├── README.md
└── memes/          # 表情包存放地
    └── index.json  # 索引文件（自动维护）

3. 配置 MCP 客户端

在你的 MCP 客户端（如 Claude Desktop, Cherry Studio）中添加配置：

Windows 示例 (Claude Desktop): 编辑 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "meme-server": {
      "command": "python",
      "args": [
        "E:\\你的路径\\meme-mcp\\meme_server.py"
      ]
    }
  }
}

使用方法

1. 查找与搜索

• 列出所有: 帮我看看有哪些表情包

• 模糊搜索: 搜一下关于“开心”的表情 (即使名称不完全匹配也会给出推荐)

2. 添加表情包 (强大的一键添加)

• 从网络添加: 把这个图片存为表情包：https://example.com/smile.gif (自动下载并命名)

• 从本地添加: 添加本地图片 C:\Users\Pics\funny.png，命名为“好笑”

• 自动处理: 如果你起名带了后缀（如 哈哈.jpg），系统会自动处理，不会出现 哈哈.jpg.jpg 的尴尬情况。

3. 删除表情包

• 删除名为“测试”的表情包 (同时删除文件和记录)

工具说明

list_memes

获取所有表情包名称列表。

get_meme

根据名称获取表情包的 HTTP URL。

• 参数: name (表情包名称)

search_memes

搜索表情包。

• 参数: keyword (关键词)

• 特色: 支持模糊匹配和相似度推荐。

add_meme

添加新表情包。

• 参数:

  • source (必填): 本地路径或 URL。

  • name (可选): 表情包名称，建议不带后缀。

• 特色: 自动下载、自动识别格式、智能防重复后缀。

delete_meme

删除表情包。

• 参数: name (表情包名称)

• 效果: 同步删除磁盘文件和索引记录。

check_server

检查图片服务器状态。

常见问题 (FAQ)

为什么图片不显示？

1. 检查 check_server 状态是否为“运行中”。

2. 确保 8000 端口未被占用（可在 meme_server.py 修改 STATIC_SERVER_PORT）。

3. 确保你的聊天软件支持显示 Markdown 图片。

如何批量导入？

直接将图片放入 memes 文件夹，然后调用一次 list_memes，服务器会自动扫描新文件并生成索引。

许可证

MIT License