表情包 MCP 服务器
一个简单的 MCP (Model Context Protocol) 服务器，用于管理和检索本地表情包图片。
功能特性
- 📋 列出所有表情包 - 获取所有可用表情包的名称列表
- 🔍 搜索表情包 - 根据关键词搜索表情包
- 🌐 获取图片 URL - 根据名称获取表情包的 HTTP URL（支持在聊天软件中显示）
- ➕ 添加表情包 - 将新图片添加到表情包索引
- 🔄 自动启动服务器 - 自动启动和管理静态资源服务器，无需手动操作
- 📊 服务器状态检查 - 随时查看静态资源服务器的运行状态
安装步骤
1. 安装依赖
pip install -r requirements.txt
2. 准备表情包
将你的表情包图片（支持 .jpg, .png, .gif, .webp 格式）放到 memes 目录中。
目录结构示例：
meme-mcp/
├── meme_server.py
├── requirements.txt
├── README.md
└── memes/
├── 笑哭.png
├── 点赞.gif
├── 疑问.jpg
└── index.json # 自动生成
3. 配置 MCP 客户端
在你的 MCP 客户端配置文件中添加：
对于 Claude Desktop (Windows):
编辑 %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"meme-server": {
"command": "python",
"args": [
"E:\\CherryStudioDaTa\\Agent\\论文\\meme-mcp\\meme_server.py"
]
}
}
}
对于 Claude Desktop (macOS/Linux):
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"meme-server": {
"command": "python3",
"args": [
"/path/to/meme-mcp/meme_server.py"
]
}
}
}
使用方法
1. 列出所有表情包
请列出所有可用的表情包
2. 搜索表情包
搜索包含"笑"的表情包
3. 获取表情包 URL
获取"笑哭"表情包的 URL
返回示例：
表情包路径: http://localhost:8000/laugh_cry.png
注意： 静态资源服务器会在首次调用 get_meme 时自动启动，无需手动操作。
4. 检查服务器状态
检查静态资源服务器状态
返回示例：
静态资源服务器状态：
- 运行状态: ✓ 运行中
- 访问地址: http://localhost:8000
- 监听端口: 8000
5. 添加新表情包
首先将图片文件复制到 memes 目录，然后：
添加表情包：名称为"新表情"，文件名为"new_meme.png"
工具说明
list_memes
获取所有可用表情包的名称列表。
参数： 无
返回： 表情包名称列表
get_meme
根据名称获取表情包的 HTTP URL（会自动启动静态资源服务器）。
参数：
name(string): 表情包的名称
返回： 表情包的 HTTP URL（格式：http://localhost:8000/文件名）
说明： 首次调用时会自动启动静态资源服务器，无需手动操作。
search_memes
根据关键词搜索表情包。
参数：
keyword(string): 搜索关键词
返回： 匹配的表情包列表
add_meme
添加新的表情包到索引。
参数：
name(string): 表情包的名称（用于查询）filename(string): 图片文件名（包含扩展名）
返回： 添加结果
check_server
检查静态资源服务器的运行状态。
参数： 无
返回： 服务器状态信息（运行状态、访问地址、监听端口）
索引文件
服务器会自动在 memes 目录下创建 index.json 文件来管理表情包索引：
{
"笑哭": "laugh_cry.png",
"点赞": "thumbs_up.gif",
"疑问": "question.jpg"
}
你可以手动编辑这个文件来自定义表情包的名称。
为什么需要静态资源服务器？
由于浏览器的安全限制（Security Sandboxing 和同源策略），基于 Electron 或浏览器内核的聊天软件（如 Cherry Studio）无法直接访问本地文件系统（如 E:\...\发呆.jpg）。
为了解决这个问题，我们搭建了一个本地静态资源服务器，将本地文件路径转换为 HTTP URL（如 http://localhost:8000/发呆.jpg），这样聊天软件就能正常加载和显示表情包了。
好消息： 静态资源服务器现在会自动启动和管理，无需手动操作！
支持的图片格式
- JPEG (.jpg, .jpeg)
- PNG (.png)
- GIF (.gif)
- WebP (.webp)
故障排除
表情包无法显示
-
检查服务器状态
- 使用
check_server工具查看静态资源服务器是否正在运行 - 如果未运行，调用
get_meme工具时会自动启动
- 使用
-
确认服务器端口未被占用
- 如果 8000 端口被其他程序占用，可以修改
meme_server.py中的STATIC_SERVER_PORT配置 - 修改后需要重启 MCP 服务器
- 如果 8000 端口被其他程序占用，可以修改
-
确认表情包文件存在
- 检查
memes目录中是否有对应的图片文件 - 使用
list_memes工具查看所有可用的表情包
- 检查
-
测试服务器访问
- 在浏览器中访问
http://localhost:8000测试是否能访问 - 如果能访问，说明服务器运行正常
- 在浏览器中访问
表情包列表为空
- 确认
memes目录中有图片文件 - 检查图片格式是否支持
- 尝试手动创建
index.json文件
无法找到表情包
- 使用
list_memes查看所有可用的表情包名称 - 确保名称完全匹配（区分大小写）
- 检查
index.json中的映射关系
文件路径错误
确保在配置文件中使用了正确的绝对路径，Windows 系统注意使用双反斜杠 \\ 或正斜杠 /。
许可证
MIT License