mcpo_docker_use

基本能力

产品定位

mcpo_docker_use 是一个 Docker 镜像，用于快速部署和运行 MCP 服务器，提供 OpenAPI 兼容的 HTTP 端点，方便与 OpenWebUI 集成。

核心功能

1. 多 MCP 服务支持：内置 amap、baidumap、server-brave-search、tavily、fetch 等 MCP 服务。
2. OpenAPI 兼容：将 MCP 服务器暴露为 OpenAPI 兼容的 HTTP 端点。
3. 预装工具：镜像中预装了 npm、curl、nodejs、uv 等工具。
4. 健康检查：支持 Docker 健康检查，确保服务正常运行。
5. 灵活配置：支持通过配置文件和环境变量自定义服务参数。

适用场景

1. OpenWebUI 集成：为 OpenWebUI 提供 MCP 服务支持。
2. 快速部署 MCP 服务：通过 Docker 快速部署和运行 MCP 服务。
3. 开发测试：用于开发和测试 MCP 服务的功能。

工具列表

1. amap-maps：提供地图服务功能。
2. brave-search：提供浏览器自动化搜索功能。
3. tavily-mcp：提供内容生成功能。
4. fetch：提供数据抓取功能。

常见问题解答

1. 如何获取 API Key：需要从各服务官网获取 API Key（如 amap-maps、brave-search、tavily）。
2. 如何配置服务：通过修改 config.json 和 docker-compose.yml 文件进行配置。
3. 如何检查服务状态：使用 Docker 健康检查功能或访问 http://localhost:8000/docs。

使用教程

使用依赖

1. 确保已安装 Docker 和 Docker Compose。
2. 确保已安装 Git。

安装教程

1. 克隆仓库： shell git clone https://github.com/flyfox666/mcpo_docker_use.git cd Mcpo-Docker
2. 复制示例文件并编辑： shell cp config.example.json config.json cp docker-compose.example.yml docker-compose.yml
3. 启动容器： shell docker compose up -d

或使用 docker run： shell docker run -d \ --name mcpo \ --restart unless-stopped \ -p 8000:8000 \ -v "$(pwd)/config.json:/app/config/config.json" \ -v "$(pwd)/logs:/app/logs" \ -e MCPO_API_KEY=xxx \ --health-cmd 'curl -f http://localhost:8000/docs' \ --health-interval=30s \ --health-timeout=10s \ --health-retries=3 \ --health-start-period=40s \ ghcr.io/flyfox666/mcpo_docker_use

或从源码构建镜像： shell docker build -t mcpo .

调试方式

1. 检查容器日志： shell docker logs mcpo
2. 访问健康检查端点： shell curl http://localhost:8000/docs
3. 检查服务状态： shell docker inspect mcpo

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。