Mingli MCP Server

# Cloudflare Tunnel 详解与部署方案对比 ## 🤔 你的问题 > **Q1**: Cloudflare Tunnel只是提供中转吗？需要我本地一直开启服务？ > > **A**: 是的！Cloudflare Tunnel是一个**代理隧道**，需要本地服务一直运行。 > **Q2**: 如果部署在线上可以吗？Cloudflare Worker之类的呢？ > > **A**: 可以部署到其他云平台，但不能用Cloudflare Workers（原因见下文）。 --- ## 📖 Cloudflare Tunnel工作原理 ### 架构图 \`\`\` ┌─────────────┐ HTTPS ┌──────────────────┐ 内网 ┌──────────────┐ │ Coze │ ──────────────> │ Cloudflare CDN │ ────────────> │ cloudflared │ │ 用户/客户端 │ │ (全球节点) │ │ (隧道客户端) │ └─────────────┘ └──────────────────┘ └──────────────┘ │ │ localhost ↓ ┌──────────────┐ │ 你的MCP服务 │ │ (Python程序) │ └──────────────┘ \`\`\` ### 工作流程 1. **用户请求** → https://mcp.lee.locker/health 2. **Cloudflare接收** → 全球CDN节点 3. **隧道转发** → 通过加密隧道到你本地的cloudflared 4. **本地处理** → cloudflared转发到localhost:8080 5. **返回响应** → 原路返回 ### 关键点 - ✅ **免费且安全**：自动HTTPS，无需公网IP - ✅ **穿透NAT**：可以在任何网络环境使用 - ⚠️ **需要本地运行**：你的电脑/服务器必须开机且运行cloudflared - ⚠️ **依赖网络**：如果本地断网或关机，服务就不可用 --- ## 🚫 为什么不能用Cloudflare Workers？ ### Cloudflare Workers限制 | 特性 | Workers | 你的项目需要 | 结果 | |------|---------|--------------|------| | 运行时 | JavaScript/WASM | Python 3.8+ | ❌ 不支持 | | 包大小 | <1MB | >100MB (依赖很多) | ❌ 超限 | | 运行时间 | CPU时间<50ms | 长时间计算 | ❌ 超时 | | 依赖 | 有限的npm包 | lunar_python等 | ❌ 不可用 | **简单说**：Cloudflare Workers只能跑JavaScript，你的项目是Python，不兼容。 --- ## 🌐 真正的线上部署方案 ### 方案对比 | 方案 | 成本 | 优势 | 劣势 | 推荐度 | |------|------|------|------|--------| | **Cloudflare Tunnel** | 免费 | 简单、安全 | 本地必须运行 | ⭐⭐⭐⭐⭐ (个人) | | **Railway** | $5/月 | 自动部署、免维护 | 需付费 | ⭐⭐⭐⭐⭐ (商用) | | **Render** | 免费层 | 简单部署 | 免费版会休眠 | ⭐⭐⭐⭐ | | **Fly.io** | $3/月起 | 全球部署 | 配置稍复杂 | ⭐⭐⭐⭐ | | **阿里云/腾讯云** | ¥30+/月 | 完全可控 | 需自己运维 | ⭐⭐⭐ | --- ## 🎯 推荐方案 ### 场景1：个人使用/测试 **推荐**：Cloudflare Tunnel **理由**： - ✅ 完全免费 - ✅ 5分钟部署 - ✅ 自己的域名 - ✅ 代码在本地，方便调试 **注意**： - 电脑需要保持开机 - 网络需要稳定 --- ### 场景2：商业使用/团队协作 **推荐**：Railway（最简单）或 Render #### Railway部署（推荐）⭐⭐⭐⭐⭐ **特点**： - ✅ GitHub一键部署 - ✅ 自动更新 - ✅ 内置监控 - ✅ 24/7运行 - 💰 $5/月（免费$5额度） **步骤**： 1. **推送代码到GitHub**（已完成✅） 2. **访问Railway** https://railway.app/ 3. **连接GitHub仓库** - New Project → Deploy from GitHub - 选择 spyfree/mingli-mcp 4. **设置环境变量** \`\`\` TRANSPORT_TYPE=http HTTP_PORT=8080 \`\`\` 5. **自动部署** - Railway会自动检测Python - 自动安装依赖 - 生成域名：https://yourapp.railway.app 6. **完成！** - 获得永久URL - 24/7运行 - 自动重启 **Coze配置**： \`\`\`json { "mcpServers": { "mingli": { "url": "https://yourapp.railway.app/mcp" } } } \`\`\` --- #### Render部署（免费备选） **特点**： - ✅ 免费层可用 - ✅ GitHub自动部署 - ⚠️ 15分钟无请求会休眠 - ⚠️ 首次请求需等待唤醒 **步骤**： 1. 访问 https://render.com 2. New → Web Service 3. 连接GitHub repo 4. 配置： - Build Command: \`pip install -r requirements.txt\` - Start Command: \`python mingli_mcp.py\` - 环境变量：TRANSPORT_TYPE=http --- ### 场景3：完全控制/企业内部 **推荐**：自己的VPS服务器 **平台选择**： - 阿里云轻量服务器：¥30/月 - 腾讯云：¥35/月 - Vultr/DigitalOcean：$6/月 **部署方式**： \`\`\`bash # 1. SSH到服务器 ssh user@your-server.com # 2. 克隆代码 git clone https://github.com/spyfree/mingli-mcp.git cd mingli-mcp # 3. 安装依赖 python3 -m venv venv source venv/bin/activate pip install -r requirements.txt # 4. 配置systemd服务（开机自启） sudo nano /etc/systemd/system/mingli-mcp.service # 5. 启动 sudo systemctl enable mingli-mcp sudo systemctl start mingli-mcp \`\`\` --- ## 🔄 Cloudflare Tunnel vs 真正部署 ### Cloudflare Tunnel（当前方案） **优势**： - ✅ 免费 - ✅ 简单 - ✅ 安全（自动HTTPS） - ✅ 使用自己的域名 **劣势**： - ❌ 本地必须一直运行 - ❌ 电脑关机就不可用 - ❌ 依赖本地网络 **适合**： - 个人开发测试 - 演示项目 - 不想付费 --- ### Railway等云平台部署 **优势**： - ✅ 24/7运行 - ✅ 无需本地开机 - ✅ 自动重启 - ✅ 全球加速 - ✅ 监控日志 **劣势**： - ❌ 需要付费（$3-10/月） - ❌ 受平台限制 **适合**： - 商业使用 - 团队协作 - 稳定服务 --- ## 💡 我的建议 ### 当前阶段（学习/测试） **使用Cloudflare Tunnel**： - 完全免费 - 已经配置好 - 修复代码后立即可用 ### 未来阶段（正式使用） **方案1**：继续用Cloudflare Tunnel - 如果是个人使用 - 电脑经常开机 - 不介意偶尔中断 **方案2**：迁移到Railway - 商业使用/团队使用 - 需要稳定服务 - 可接受$5/月成本 --- ## 🚀 立即行动 ### 修复Cloudflare Tunnel（5分钟） \`\`\`bash # 终端1 - 启动MCP服务 cd /Users/lix18854/Documents/code/ziwei_mcp source venv/bin/activate export TRANSPORT_TYPE=http export HTTP_PORT=8080 python mingli_mcp.py # 终端2 - 启动隧道 cloudflared tunnel run mingli-mcp # 终端3 - 测试 curl https://mcp.lee.locker/health \`\`\` ### 或部署到Railway（10分钟） 1. 访问 https://railway.app 2. 登录并连接GitHub 3. 选择 spyfree/mingli-mcp 4. 设置环境变量（TRANSPORT_TYPE=http） 5. 自动部署 --- ## 📞 总结回答 **Q**: Cloudflare Tunnel只是中转吗？需要本地一直开？ **A**: ✅ 是的！它是代理隧道，本地服务必须运行。 **Q**: 能部署到线上吗？ **A**: ✅ 可以！推荐Railway或Render，但不能用Cloudflare Workers（不支持Python）。 **Q**: 哪个方案最好？ **A**: - 🏠 **个人测试**：Cloudflare Tunnel（免费） - 💼 **商业使用**：Railway（$5/月） - 🏢 **企业内部**：自己的服务器 --- 选择最适合你的方案，有问题随时问我！