@mcp/openverse 是一个 MCP(模型上下文协议)服务器,它提供了从 Openverse 搜索和获取开放许可图像的工具。借助该服务器,用户能够轻松地找到符合各种需求的开放许可图像。
你可以通过以下步骤快速使用 @mcp/openverse 服务器:
你可以通过以下两种方式安装 @mcp/openverse:
npm install -g @mcp/openverse
git clone https://github.com/yourusername/mcp-openverse.git
cd mcp-openverse
npm install
npm run build
npm link
将以下配置添加到你的 Claude Desktop 配置文件(~/Library/Application Support/Claude/claude_desktop_config.json
)中:
{
"mcpServers": {
"openverse": {
"command": "npx",
"args": ["@mcp/openverse"]
}
}
}
如果你是本地安装的,可以使用以下配置:
{
"mcpServers": {
"openverse": {
"command": "node",
"args": ["/path/to/mcp-openverse/dist/index.js"]
}
}
}
search_images
使用各种过滤器搜索开放许可的图像。
参数说明:
query
(必填):搜索词。page
:页码(默认值:1)。page_size
:每页结果数(默认值:20,最大值:500)。license
:许可类型(如 by
, by-sa
, by-nc
, by-nd
, cc0
等)。license_type
:commercial
或 modification
。creator
:按创作者名称过滤。source
:按来源过滤(如 flickr
, wikimedia
, met
等)。extension
:文件类型(如 jpg
, png
, gif
, svg
)。aspect_ratio
:tall
, wide
, 或 square
。size
:small
, medium
, 或 large
。mature
:是否包含成人内容(默认值:false)。示例:
// 搜索具有商业许可的自然照片
{
"query": "forest landscape",
"page_size": 10,
"license_type": "commercial",
"extension": "jpg",
"aspect_ratio": "wide"
}
get_image_details
获取特定图像的详细信息。
参数说明:
image_id
(必填):Openverse 图像 ID(UUID 格式)。get_related_images
查找与特定图像相关的图像。
参数说明:
image_id
(必填):要查找相关图像的图像 ID。page
:页码(默认值:1)。page_size
:每页结果数(默认值:10)。get_image_stats
按来源获取可用图像的统计信息。
参数说明:无。
search_images_for_essay
用于为文章或论文查找配图的高级工具。
参数说明:
essay_topic
(必填):文章的主要主题/标题。concepts
(必填):用于查找图像的关键概念数组。style
:photo
, illustration
, 或 any
(默认值:any
)。max_images
:返回的最大图像数(默认值:10)。示例:
{
"essay_topic": "Climate Change",
"concepts": ["global warming", "renewable energy", "carbon emissions"],
"style": "photo",
"max_images": 15
}
所有来自 Openverse 的图像都有版权声明要求。API 提供以下信息:
attribution
:预格式化的版权声明文本。license
:许可代码(如 'by-sa')。license_url
:许可链接。creator
:原始创作者/摄影师。creator_url
:创作者资料链接。在使用图像时,请始终包含适当的版权声明。
Openverse API 有以下速率限制:
此 MCP 服务器目前使用匿名访问。如需更高的速率限制,请考虑实现 OAuth 认证。
npm install
npm run build
npm run dev
你可以使用 MCP 检查器来测试服务器:
npx @modelcontextprotocol/inspector dist/index.js
// 使用 search_images_for_essay 工具
{
"essay_topic": "Sustainable Architecture",
"concepts": ["green building", "solar panels", "eco-friendly design"],
"style": "photo",
"max_images": 10
}
// 使用 search_images 工具
{
"query": "mountain landscape sunrise",
"aspect_ratio": "wide",
"license_type": "commercial",
"extension": "jpg",
"size": "large",
"page_size": 20
}
设置 DEBUG
环境变量:
DEBUG=mcp:* npx @mcp/openverse
本项目采用 MIT 许可证,详情请参阅 LICENSE 文件。
欢迎贡献代码!请随时提交拉取请求。