lanhu-mcp

环境要求

• Python 3.10+（源码运行时需要）
• Docker 与 Docker Compose（Docker 部署时使用）
• 支持视觉功能的 AI 模型，如 Claude、GPT、Gemini、Kimi、Qwen、DeepSeek
• 蓝湖账号及其 Cookie

安装与启动步骤

1. 1选择视觉模型

   必须使用具备图像识别能力的模型，纯文本模型如 GPT-3.5、Claude Instant 不可用。

2. 2获取蓝湖 Cookie

   登录蓝湖网页版，打开浏览器开发者工具，从请求头中复制 Cookie 备用。

3. 3配置环境变量

   在项目目录运行脚本，交互式获取并配置蓝湖 Cookie，自动生成 .env 文件。

   bash setup-env.sh

   复制

4. 4启动 Docker 服务

   使用 Docker Compose 启动服务，服务器默认监听 8000 端口。

   docker-compose up -d

   复制

5. 5查看运行日志

   跟踪容器日志，确认服务无报错并正常启动。

   docker-compose logs -f

   复制

6. 6源码安装依赖

   源码运行替代方案：安装 Python 依赖并下载 Playwright 的 Chromium 浏览器。

   pip install -r requirements.txt
   playwright install chromium

   复制

7. 7源码启动服务

   设置 LANHU_COOKIE 等环境变量后，运行脚本启动 HTTP 版 MCP 服务。

   python lanhu_mcp_server.py

   复制

8. 8stdio 按需启动

   适合 Cursor、Claude Code 等本地 MCP 客户端按需拉起服务，无需常驻 HTTP。

   ./run-stdio.sh

   复制

关键配置

如何确认成功

执行 docker-compose logs -f 无报错，且 http://localhost:8000/mcp 可访问即启动成功。

常见问题

注意事项

• 必须使用支持视觉功能的 AI 模型，纯文本模型无法使用本项目。
• setup-env.sh 会交互式引导获取并配置蓝湖 Cookie，自动生成 .env 文件。
• 源码运行需 Python 3.10+，并执行 playwright install chromium。
• 服务启动后 MCP 地址为 http://localhost:8000/mcp。