基本能力
产品定位
mcpo_docker_use 是一个 Docker 镜像,用于快速部署和运行 MCP 服务器,提供 OpenAPI 兼容的 HTTP 端点,方便与 OpenWebUI 集成。
核心功能
- 多 MCP 服务支持:内置 amap、baidumap、server-brave-search、tavily、fetch 等 MCP 服务。
- OpenAPI 兼容:将 MCP 服务器暴露为 OpenAPI 兼容的 HTTP 端点。
- 预装工具:镜像中预装了 npm、curl、nodejs、uv 等工具。
- 健康检查:支持 Docker 健康检查,确保服务正常运行。
- 灵活配置:支持通过配置文件和环境变量自定义服务参数。
适用场景
- OpenWebUI 集成:为 OpenWebUI 提供 MCP 服务支持。
- 快速部署 MCP 服务:通过 Docker 快速部署和运行 MCP 服务。
- 开发测试:用于开发和测试 MCP 服务的功能。
工具列表
- amap-maps:提供地图服务功能。
- brave-search:提供浏览器自动化搜索功能。
- tavily-mcp:提供内容生成功能。
- fetch:提供数据抓取功能。
常见问题解答
- 如何获取 API Key:需要从各服务官网获取 API Key(如 amap-maps、brave-search、tavily)。
- 如何配置服务:通过修改
config.json
和docker-compose.yml
文件进行配置。 - 如何检查服务状态:使用 Docker 健康检查功能或访问
http://localhost:8000/docs
。
使用教程
使用依赖
- 确保已安装 Docker 和 Docker Compose。
- 确保已安装 Git。
安装教程
- 克隆仓库:
shell
git clone https://github.com/flyfox666/mcpo_docker_use.git
cd Mcpo-Docker - 复制示例文件并编辑:
shell
cp config.example.json config.json
cp docker-compose.example.yml docker-compose.yml - 启动容器:
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 .
调试方式
- 检查容器日志:
shell
docker logs mcpo - 访问健康检查端点:
shell
curl http://localhost:8000/docs - 检查服务状态:
shell
docker inspect mcpo