Supercoordination MCP Server

# 超协体MCP服务器 - 快速启动指南 ## 🚀 日常启动（推荐） ### 方式1: 使用启动脚本（自动防休眠） ```bash cd ~/ClaudeWorkspace/supercoordination-mcp ./start-server.sh ``` **特点**: - ✅ 自动防止Mac休眠 - ✅ 显示本机IP和服务地址 - ✅ 友好的启动提示 --- ### 方式2: 直接启动 ```bash cd ~/ClaudeWorkspace/supercoordination-mcp npm start ``` **特点**: - ✅ 最简单 - ⚠️ 不防止Mac休眠（需要手动执行 `caffeinate -i`） --- ## 📋 完整操作流程 ### 第一次启动（关闭终端后） 1. **打开新终端** 2. **执行启动命令**: ```bash cd ~/ClaudeWorkspace/supercoordination-mcp ./start-server.sh ``` 3. **看到启动成功信息**: ``` 🌟════════════════════════════════════════════════════🌟 超协体 · 人机协同MCP服务器 v1.0 启动成功！ 🌟════════════════════════════════════════════════════🌟 [数据持久化] 已加载: 1 个任务, 1 个成员 [数据持久化] 上次保存时间: 2026-01-20T17:41:21.279Z 📍 本地访问: http://localhost:3000 📍 局域网访问: http://192.168.1.3:3000 ``` 4. **保持终端窗口开启**（最小化即可） --- ## ⚙️ 高级选项 ### 后台运行（推荐用于服务器） **启动**: ```bash cd ~/ClaudeWorkspace/supercoordination-mcp nohup npm start > logs/server.log 2>&1 & ``` **查看日志**: ```bash tail -f logs/server.log ``` **停止**: ```bash pkill -f "node src/server.js" ``` --- ### 使用PM2守护进程（生产环境推荐） **安装PM2**: ```bash npm install -g pm2 ``` **启动**: ```bash cd ~/ClaudeWorkspace/supercoordination-mcp pm2 start src/server.js --name supercoordination ``` **查看状态**: ```bash pm2 status pm2 logs supercoordination ``` **停止/重启**: ```bash pm2 stop supercoordination pm2 restart supercoordination ``` **开机自启动**: ```bash pm2 startup pm2 save ``` --- ## 🔍 启动检查清单 启动后验证以下几点： ### 1. 查看启动日志 ``` ✅ 看到："启动成功" ✅ 看到："[数据持久化] 已加载: X 个任务, Y 个成员" ✅ 看到："局域网访问: http://192.168.1.3:3000" ``` ### 2. 测试健康检查 ```bash curl http://localhost:3000/health ``` **应该返回**: ```json { "status": "healthy", "timestamp": "...", "stats": { "tasks": 1, "members": 1 } } ``` ### 3. 测试MCP端点 ```bash curl http://192.168.1.3:3000/mcp ``` **应该返回**: ```json { "name": "超协体协作中枢", "version": "1.0.0", ... } ``` --- ## ❓ 常见问题 ### Q1: 端口被占用怎么办？ **错误信息**: `EADDRINUSE: address already in use` **解决方法**: ```bash # 查找占用进程 lsof -i :3000 # 停止占用进程 kill -9 [PID] # 或者直接清理所有Node服务器 pkill -f "node src/server.js" # 重新启动 ./start-server.sh ``` --- ### Q2: 如何查看服务器是否在运行？ ```bash # 方法1: 检查进程 ps aux | grep "node src/server.js" | grep -v grep # 方法2: 测试健康检查 curl http://localhost:3000/health # 方法3: 查看端口 lsof -i :3000 ``` --- ### Q3: 数据丢失了怎么办？ **检查数据文件**: ```bash ls -lh data/store.json cat data/store.json | jq . ``` **从备份恢复**: ```bash # 如果有备份 cp data/backups/最新备份.json data/store.json # 重启服务器 pkill -f "node src/server.js" ./start-server.sh ``` --- ### Q4: Mac休眠后服务器停止了？ **原因**: 未使用防休眠启动 **解决**: ```bash # 方式1: 使用启动脚本（自动防休眠） ./start-server.sh # 方式2: 手动防休眠 caffeinate -i npm start # 方式3: 系统设置 # 系统偏好设置 → 节能 → 防止Mac自动进入睡眠（接通电源时） ``` --- ## 🎯 快速命令备忘录 ### 启动服务器 ```bash cd ~/ClaudeWorkspace/supercoordination-mcp && ./start-server.sh ``` ### 停止服务器 ```bash pkill -f "node src/server.js" ``` ### 重启服务器 ```bash pkill -f "node src/server.js" && sleep 2 && cd ~/ClaudeWorkspace/supercoordination-mcp && ./start-server.sh ``` ### 查看数据 ```bash cat ~/ClaudeWorkspace/supercoordination-mcp/data/store.json | jq . ``` ### 备份数据 ```bash cp ~/ClaudeWorkspace/supercoordination-mcp/data/store.json ~/Desktop/超协体备份_$(date +%Y%m%d).json ``` --- ## 📱 添加到Alfred/Raycast快捷启动（可选） ### Alfred Workflow ```bash # 关键词: start-mcp cd ~/ClaudeWorkspace/supercoordination-mcp && ./start-server.sh ``` ### Raycast Script 创建文件: `start-supercoordination.sh` ```bash #!/bin/bash cd ~/ClaudeWorkspace/supercoordination-mcp ./start-server.sh ``` --- ## 🔔 一键启动别名（推荐） **添加到 ~/.zshrc**: ```bash # 超协体MCP快捷命令 alias mcp-start='cd ~/ClaudeWorkspace/supercoordination-mcp && ./start-server.sh' alias mcp-stop='pkill -f "node src/server.js"' alias mcp-restart='pkill -f "node src/server.js" && sleep 2 && cd ~/ClaudeWorkspace/supercoordination-mcp && ./start-server.sh' alias mcp-status='curl -s http://localhost:3000/health | jq .' alias mcp-data='cat ~/ClaudeWorkspace/supercoordination-mcp/data/store.json | jq .' ``` **使用方法**: ```bash # 启动 mcp-start # 停止 mcp-stop # 重启 mcp-restart # 查看状态 mcp-status # 查看数据 mcp-data ``` --- ## 🌟 最佳实践 ### 日常工作流 **早上开始工作**: ```bash # 1. 打开终端 # 2. 启动服务器 mcp-start # 3. 看到"启动成功"后，最小化终端 # 4. 开始使用Claude Code ``` **晚上结束工作**: ```bash # 方式1: 保持服务器运行（推荐） # - 直接关闭终端即可（进程会被终止） # - 或最小化终端，让服务器继续运行 # 方式2: 手动停止（如果想省电） mcp-stop ``` --- ## 📞 快速参考 **项目目录**: `~/ClaudeWorkspace/supercoordination-mcp` **启动命令**: `./start-server.sh` **数据文件**: `data/store.json` **服务端口**: 3000 **局域网地址**: `http://192.168.1.3:3000/mcp` **一行启动**: ```bash cd ~/ClaudeWorkspace/supercoordination-mcp && ./start-server.sh ``` --- **当前版本**: v1.1 **数据持久化**: ✅ 已启用 **自动加载**: ✅ 启动时恢复数据 🎉 **快速启动，简单高效！**