Docker Hub自述MCP服务器
 ](https://www.npmjs.com/package/docker-hub-readme-mcp-server) ](https://www.npmjs.com/package/docker-hub-readme-mcp-server) ](https://github.com/elchika-inc/docker-hub-readme-mcp-server)
MCP(模型上下文协议)服务器,使AI助手能够从Docker Hub获取有关Docker镜像的全面信息,包括README内容、镜像元数据和搜索功能。
特性
- 包README检索:从Docker Hub上托管的Docker镜像中获取格式化的README内容和使用示例
- 包裹信息:获取全面的图像元数据,包括可用标签、下载统计信息和配置详细信息
- 程序包搜索:通过官方镜像、自动构建和流行度进行过滤,搜索Docker Hub
- 智能缓存:智能缓存系统,可优化API的使用并提高响应时间
- GitHub集成:与GitHub API无缝集成,增强从链接存储库获取自述文件的能力
- 错误处理:具有自动重试逻辑和回退策略的强大错误处理
MCP客户端配置
将此服务器添加到MCP客户端配置中:
{
"mcpServers": {
"docker-hub-readme": {
"command": "npx",
"args": ["docker-hub-readme-mcp-server"],
"env": {
"GITHUB_TOKEN": "your_github_token_here"
}
}
}
}备注:The GITHUB_TOKEN 是可选的,但建议在从GitHub获取README内容时使用更高的API速率限制。可用工具
get_package_readme
检索Docker镜像的全面README内容和使用示例。
参数:
{
"package_name": "nginx",
"version": "latest",
"include_examples": true
}package_name(字符串,必填):Docker镜像名称(例如,“nginx”、“postgres”、“microsoft.com”)version(字符串,可选):特定图像标签或“最新”(默认:“最新的”)include_examples(布尔值,可选):包括使用示例和Docker命令(默认值:true)
退货: 格式化的README内容,包括Docker运行命令、使用示例和配置文档。
get_package_info
从Docker Hub获取详细的图像元数据、标签和统计数据。
参数:
{
"package_name": "postgres",
"include_dependencies": true,
"include_tags": true
}package_name(string,必填):Docker镜像名称include_dependencies(布尔值,可选):包括基本图像信息(默认值:true)include_tags(布尔值,可选):包括可用标记(默认值:true)
退货: 图像元数据,包括可用标签、维护者信息、下载统计数据和平台支持。
搜索包
在Docker Hub中搜索具有过滤功能的映像。
参数:
{
"query": "web server",
"limit": 20,
"official_only": false
}query(字符串,必填):搜索词(图像名称、描述、关键字)limit(number,可选):返回的最大结果数(默认值:20,最大值:100)official_only(布尔值,可选):仅过滤官方图片(默认值:false)
退货: 包含名称、描述、星数和拉取统计信息的匹配图像列表。
错误处理
服务器优雅地处理常见错误场景:
- 未找到图像:返回带有类似图像建议的清晰错误消息
- 速率限制:实现指数回退的自动重试
- 网络超时:具有重试逻辑的可配置超时
- 图像名称无效:验证图像名称格式并提供指导
- Docker Hub API故障:API不可用时的回退策略
许可证
麻省理工学院
