🚀 Giphy GIF MCP 服务器
Giphy GIF MCP 服务器是一个针对 Giphy API 的 MCP 服务器，它让 AI 模型能够便捷地搜索、检索并使用来自 Giphy 的 GIF，为 AI 应用在多媒体素材获取方面提供了有力支持。
✨ 主要特性
- 内容过滤：可以按照评级（G, PG, PG - 13, R）对搜索结果进行筛选，有效确保获取到适当的内容。
- 优化的响应格式：响应数据针对 AI 模型的消费需求进行了优化，便于 AI 模型处理和使用。
- 多种搜索方法：支持基于查询、随机和热门 GIF 的检索方式，满足不同场景下的使用需求。
- 全面元数据：每个 GIF 都附带完整的元数据，包括尺寸、格式和归属信息等，方便用户了解和使用。
- 分页支持：能够控制结果数量和分页，从而高效地使用 API，避免数据冗余。
📦 安装指南
使用 Smithery 安装
- 访问 Smithery。
- 搜索并选择
mcp-server-giphy项目。 - 点击“部署”按钮，然后根据提示完成安装。
手动安装
- 克隆仓库：
git clone https://github.com/magarcia/mcp-server-giphy.git
- 安装依赖项：
cd mcp-server-giphy
npm install
- 启动服务器：
npm start
💻 使用示例
基础用法
搜索 GIF
# 使用 search_gifs 工具搜索 GIF
# 这里假设使用 Python 调用 API，实际情况可能需要根据具体 API 调用方式调整
import requests
query = "cat"
limit = 10
offset = 0
rating = "g"
lang = "en"
url = f"https://your-api-url/search_gifs?query={query}&limit={limit}&offset={offset}&rating={rating}&lang={lang}"
response = requests.get(url)
print(response.json())
获取随机 GIF
# 使用 get_random_gif 工具获取随机 GIF
tag = "funny"
rating = "pg"
url = f"https://your-api-url/get_random_gif?tag={tag}&rating={rating}"
response = requests.get(url)
print(response.json())
获取热门 GIF
# 使用 get_trending_gifs 工具获取热门 GIF
limit = 15
offset = 0
url = f"https://your-api-url/get_trending_gifs?limit={limit}&offset={offset}"
response = requests.get(url)
print(response.json())
高级用法
结合分页和多条件搜索
# 搜索包含 "dog" 的 GIF，每页显示 20 条结果，从第 2 页开始
query = "dog"
limit = 20
offset = 20
rating = "pg-13"
lang = "fr"
url = f"https://your-api-url/search_gifs?query={query}&limit={limit}&offset={offset}&rating={rating}&lang={lang}"
response = requests.get(url)
print(response.json())
📚 详细文档
工具说明
search_gifs
- 功能：使用查询字符串在 Giphy 上搜索 GIF。
- 输入：
query（字符串）：搜索查询词或短语。limit（可选数字）：最多返回对象的数量（默认：10，最大：50）。offset（可选数字）：结果偏移量（默认：0）。rating（可选字符串）：内容评级（g, pg, pg - 13, r）。lang（可选字符串）：语言代码（默认：en）。
- 返回：包含元数据的 GIF 对象数组。
get_random_gif
- 功能：从 Giphy 获取一个随机 GIF，可选按标签过滤。
- 输入：
tag（可选字符串）：用于限制随机结果的标签。rating（可选字符串）：内容评级（g, pg, pg - 13, r）。
- 返回：包含元数据的随机 GIF 对象。
get_trending_gifs
- 功能：获取 Giphy 上当前热门的 GIF。
- 输入：
limit（可选数字）：最多返回对象的数量（默认：10，最大：50）。offset（可选数字）：结果偏移量（默认：0）。
- 返回：包含元数据的热门 GIF 对象数组。
响应格式
每个工具的响应将返回以下结构：
{
"gifs": [
{
"id": "string",
"url": "string",
"width": "number",
"height": "number",
"username": "string",
"avatar_url": "string",
"is_sticky": "boolean",
"created_at": "string",
"updated_at": "string"
}
]
}
🔧 技术细节
该服务器基于相关技术对 Giphy API 进行封装和扩展，以实现多种搜索功能和优化响应格式。通过对输入参数的处理和对 Giphy API 的调用，将符合条件的 GIF 数据以特定的结构返回给调用者。在分页处理方面，利用 limit 和 offset 参数控制结果的数量和起始位置，确保数据的高效获取。对于内容过滤，根据 rating 参数筛选出符合评级要求的 GIF。
📄 许可证
此项目根据 MIT 许可证授权。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。
项目仓库
https://github.com/magarcia/mcp-server-giphy
贡献指南
请参考 贡献指南。