Mingli MCP Server

# 🎉 部署状态总结 生成时间：$(date +"%Y-%m-%d %H:%M:%S") --- ## ✅ 所有部署完成！ ### 1. GitHub ✅ - **仓库**：https://github.com/spyfree/mingli-mcp - **状态**：✅ 代码已推送 - **最新提交**：Fix config.get() and HttpTransport.stop() issues - **文件数**：45+个文件 - **代码量**：7500+行 ### 2. PyPI ✅ - **包名**：mingli-mcp - **版本**：v1.0.1 - **状态**：✅ 可正常安装使用 - **链接**：https://pypi.org/project/mingli-mcp/1.0.1/ **安装测试**： \`\`\`bash $ pip install mingli-mcp Successfully installed mingli-mcp-1.0.1 \`\`\` ### 3. 本地服务 ✅ - **状态**：✅ 启动成功 - **端口**：8080 - **协议**：HTTP **测试结果**： \`\`\`bash $ curl http://localhost:8080/health {"status":"healthy","transport":"http","systems":["ziwei","bazi"]} \`\`\` ### 4. Cloudflare Tunnel ⏳ - **DNS**：✅ mcp.lee.locker 配置正确 - **隧道**：✅ 已创建 - **服务**：⏳ 需要启动 --- ## 🚀 三种使用方式 ### 方式1：Cloudflare Tunnel（推荐用于个人） **启动命令**： \`\`\`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 - Cloudflare隧道 cloudflared tunnel run mingli-mcp # 测试 curl https://mcp.lee.locker/health \`\`\` **Coze配置**： \`\`\`json { "mcpServers": { "mingli": { "url": "https://mcp.lee.locker/mcp", "headers": { "Content-Type": "application/json" } } } } \`\`\` **优势**： - ✅ 完全免费 - ✅ 自己的域名 - ✅ 代码在本地，便于调试 - ✅ 自动HTTPS **劣势**： - ⚠️ 需要电脑一直开机 - ⚠️ 依赖本地网络 --- ### 方式2：PyPI包（推荐用于stdio模式） **安装**： \`\`\`bash pip install mingli-mcp \`\`\` **Coze配置**： \`\`\`json { "mcpServers": { "mingli": { "command": "uvx", "args": ["mingli-mcp@1.0.1"] } } } \`\`\` **优势**： - ✅ 标准安装方式 - ✅ 易于分发 - ✅ 版本管理方便 --- ### 方式3：云平台部署（推荐用于商业） #### Railway（最简单） **步骤**： 1. 访问 https://railway.app 2. 连接 GitHub 仓库：spyfree/mingli-mcp 3. 设置环境变量： \`\`\` TRANSPORT_TYPE=http HTTP_PORT=8080 \`\`\` 4. 自动部署 **成本**：$5/月（有免费$5额度） **优势**： - ✅ 24/7运行 - ✅ 无需本地开机 - ✅ 自动重启 - ✅ 内置监控 **Coze配置**： \`\`\`json { "mcpServers": { "mingli": { "url": "https://yourapp.railway.app/mcp" } } } \`\`\` --- ## 🔧 本地开发快速启动 \`\`\`bash # 1. 克隆代码（如果是新环境） git clone https://github.com/spyfree/mingli-mcp.git cd mingli-mcp # 2. 创建虚拟环境 python3 -m venv venv source venv/bin/activate # 3. 安装依赖 pip install -r requirements.txt # 4. 运行服务 export TRANSPORT_TYPE=http python mingli_mcp.py # 5. 测试 curl http://localhost:8080/health \`\`\` --- ## 📊 功能清单 ### 紫微斗数（Ziwei Doushu） - ✅ \`get_ziwei_chart\` - 完整排盘 - 命盘十二宫 - 主星、辅星、四化 - 大限流年 - ✅ \`get_ziwei_fortune\` - 运势查询 - 大限 - 流年、流月、流日、流时 - ✅ \`analyze_ziwei_palace\` - 宫位分析 - 星曜配置 - 宫位特征 ### 八字（Bazi） - ✅ \`get_bazi_chart\` - 四柱排盘 - 年月日时四柱 - 十神分析 - 地支藏干 - ✅ \`get_bazi_fortune\` - 运势查询 - 大运 - 流年运势 - ✅ \`analyze_bazi_element\` - 五行分析 - 五行强弱 - 平衡度 - 喜用神建议 ### 通用功能 - ✅ \`list_fortune_systems\` - 列出所有可用系统 - ✅ 支持阳历/农历转换 - ✅ 支持JSON和Markdown双格式输出 --- ## 🎯 测试用例 ### 在Coze中测试 \`\`\` 1. 列出所有命理系统 2. 帮我排一个紫微斗数盘：2000年8月16日，寅时，女性，阳历 3. 帮我看看八字：2000-08-16，寅时，女 4. 分析这个八字的五行平衡：2000年8月16日寅时女性 5. 查看紫微斗数命宫分析：2000年8月16日寅时女性 \`\`\` ### API测试 \`\`\`bash # 健康检查 curl http://localhost:8080/health # 列出系统 curl -X POST http://localhost:8080/mcp \\ -H "Content-Type: application/json" \\ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "list_fortune_systems", "arguments": {} } }' # 紫微排盘 curl -X POST http://localhost:8080/mcp \\ -H "Content-Type: application/json" \\ -d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "get_ziwei_chart", "arguments": { "date": "2000-08-16", "time_index": 2, "gender": "女", "calendar": "solar" } } }' \`\`\` --- ## 📚 相关文档 | 文档 | 说明 | |------|------| | \`README.md\` | 项目总览 | | \`CLOUDFLARE_EXPLAINED.md\` | Cloudflare详解和部署对比 | | \`SUCCESS_REPORT.md\` | PyPI发布成功报告 | | \`PYPI_FIXED.md\` | v1.0.1修复说明 | | \`DEPLOYMENT_SUMMARY.md\` | 三种方案总结 | | \`ARCHITECTURE.md\` | 架构设计 | --- ## 🐛 问题排查 ### 问题1：Cloudflare 530错误 **现象**：访问 https://mcp.lee.locker 返回530 **原因**：本地服务或隧道未运行 **解决**： \`\`\`bash # 检查服务 lsof -i :8080 # 如果没有，启动服务 python mingli_mcp.py # 检查隧道 ps aux | grep cloudflared # 如果没有，启动隧道 cloudflared tunnel run mingli-mcp \`\`\` ### 问题2：PyPI安装后无法导入 **现象**：\`ModuleNotFoundError: No module named 'mingli_mcp'\` **原因**：安装了v1.0.0（有bug） **解决**： \`\`\`bash # 升级到v1.0.1 pip install --no-cache-dir --upgrade mingli-mcp \`\`\` ### 问题3：本地启动报错 **现象**：AttributeError或TypeError **原因**：代码已修复，需要拉取最新代码 **解决**： \`\`\`bash cd /Users/lix18854/Documents/code/ziwei_mcp git pull origin main source venv/bin/activate python mingli_mcp.py \`\`\` --- ## 🔐 安全建议 ### 重要：重新生成PyPI Token 之前使用的token已暴露，建议重新生成： 1. 访问：https://pypi.org/manage/account/token/ 2. 删除旧token 3. 创建新token（选择 Project: mingli-mcp 更安全） 4. 保存到安全的地方 ### API密钥保护（可选） 如果需要保护HTTP端点： \`\`\`bash export HTTP_API_KEY=your-secret-key-here python mingli_mcp.py \`\`\` Coze配置添加认证： \`\`\`json { "mcpServers": { "mingli": { "url": "https://mcp.lee.locker/mcp", "headers": { "Authorization": "Bearer your-secret-key-here" } } } } \`\`\` --- ## 📈 下一步 ### 立即可做 1. **启动Cloudflare服务**（5分钟） - 本地MCP服务 - Cloudflare隧道 - 测试访问 2. **在Coze配置使用**（5分钟） - 选择一种方式 - 配置JSON - 测试命理功能 ### 可选优化 1. **开机自启动** - systemd服务（Linux） - launchd服务（macOS） 2. **监控和日志** - 添加日志文件 - 配置日志轮转 3. **部署到云端** - Railway部署 - Render部署 - 独立VPS --- ## 🎊 总结 **已完成**： - ✅ GitHub代码托管 - ✅ PyPI包发布（v1.0.1可用） - ✅ Cloudflare DNS配置 - ✅ 本地服务调试成功 - ✅ 完整文档 **待完成**： - ⏳ 启动Cloudflare Tunnel - ⏳ 在Coze测试使用 - ⏳ （可选）部署到云平台 **三种方式任选**： 1. 🏠 Cloudflare Tunnel - 免费，需本地运行 2. 📦 PyPI包 - stdio模式 3. ☁️ 云平台 - 付费，24/7运行 --- **生成时间**：$(date) 恭喜你成功部署了完整的命理MCP服务！ 🎉