MCP Server Giphy
Giphy API的MCP服务器,使AI模型能够搜索、检索和使用Giphy上的GIF。
功能
- 内容过滤:通过评分(G、PG、PG-13、R)过滤结果,确保内容适当
- 优化响应格式:响应数据针对AI模型进行优化
- 多种搜索方式:支持基于查询、随机和热门GIF检索
- 全面元数据:每个GIF都附带完整元数据,包括尺寸、格式和归属信息
- 分页支持:控制结果大小和分页,实现高效的API使用
工具
-
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)rating(可选字符串):内容评分(g、pg、pg-13、r)
- 返回:包含元数据的GIF对象数组
响应格式
响应中的每个GIF包含:
id:Giphy的唯一标识符title:GIF标题url:Giphy网站上的GIF URLimages:包含各种图像格式的对象,每个格式包含:url:图像文件的直接URLwidth:图像宽度height:图像高度
- 额外的元数据(如有)
设置
Giphy API密钥
- 注册Giphy开发者账号
- 创建应用以获取API密钥
- 根据需求选择免费套餐或付费选项
环境配置
创建.env文件并添加您的API密钥:
GIPHY_API_KEY=your_api_key_here
与Claude Desktop一起使用
要在Claude Desktop中使用此工具,请将以下内容添加到您的claude_desktop_config.json:
{
"mcpServers": {
"giphy": {
"command": "npx",
"args": ["-y", "mcp-server-giphy"],
"env": {
"GIPHY_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
开发
# 安装依赖
npm install
# 构建项目
npm run build
# 启动服务器
npm start
# 以热重载模式开发
npm run dev
# 运行测试
npm test
# 使用MCP Inspector
npm run inspector
许可证
此MCP服务器根据MIT许可证授权。这意味着您可以自由使用、修改和分发软件,但需遵守MIT许可证的条款和条件。更多详情请参阅项目存储库中的LICENSE文件。