Supercoordination MCP Server

# 超协体项目文档结构 ## 📁 目录树 ``` supercoordination-mcp/ ├── 📦 核心技术文件 │ ├── src/ │ │ └── server.js (747行) MCP服务器核心实现 │ ├── data/ │ │ └── store.json (568B) 持久化数据存储 │ ├── .mcp.json MCP配置文件 │ ├── package.json 项目依赖配置 │ └── package-lock.json 依赖锁定文件 │ ├── 📚 产品文档 │ ├── 超协体产品介绍.md (13K) 完整产品介绍 (10,000+字) │ ├── 超协体产品介绍-精简版.md (4.7K) 精简版介绍 (3,000字) │ ├── 超协体产品介绍.html (18K) 可视化产品介绍页面 │ └── 产品介绍文档清单.md (6.6K) 文档目录索引 │ ├── 👥 团队协作文档 │ ├── 团队成员接入指南.md (8.4K) 新成员完整接入流程 │ ├── 邀请消息.md (3.8K) 邀请话术模板 │ └── 快速邀请-微信版.txt (1.1K) 微信邀请模板 │ ├── 🚀 启动与运维 │ ├── start-server.sh (1.3K) 服务器启动脚本 │ ├── 启动命令.txt (63B) 快速启动命令 │ ├── 快速启动指南.md (6.3K) 启动方式大全 │ └── 服务器启动检查清单.md (4.4K) 启动前检查事项 │ ├── 🔧 技术说明文档 │ ├── README.md (2.8K) 项目说明 │ ├── 数据持久化说明.md (6.2K) 数据存储技术文档 │ ├── 任务列表使用说明.md (5.1K) 专用任务列表配置 ⭐NEW │ ├── test-flow.md (8.2K) 测试流程文档 │ └── 项目文档结构.md (7.6K) 本文档 │ └── 📊 运行时 └── node_modules/ (74个依赖包) ``` ## 📂 文件分类说明 ### ⭐⭐⭐⭐⭐ 核心技术文件 (5个) **1. src/server.js** (747行) - **作用**: MCP协作中枢服务器核心实现 - **功能**: - 10个协作工具: 成员注册、任务创建、任务分配、资源管理等 - 五行匹配算法: Skill Match (40%) + Wuxing (30%) + Load Balance (30%) - HTTP端点: `/mcp`, `/mcp/manifest`, `/mcp/tools/call` - 数据持久化: 自动保存到JSON文件 - **关键版本**: v1.1 (已支持数据持久化) **2. data/store.json** (568字节) - **作用**: 持久化数据存储 - **内容**: - 当前成员: 1人 (十笔) - 当前任务: 1个 (撰写超协体社区推广文案) - 上次保存时间: 2026-01-20T17:41:21.279Z - **更新机制**: 每次数据修改自动保存 **3. .mcp.json** - **作用**: MCP协议配置文件 - **定义**: 服务器名称、版本、能力声明 **4. package.json** + **package-lock.json** - **作用**: Node.js项目配置 - **依赖**: Express (服务器框架) - **脚本**: `npm start` 启动服务器 ### ⭐⭐⭐⭐ 产品文档 (4个) **5. 超协体产品介绍.md** (13K, 10,000+字) - **章节**: 1. 产品定位与理念 (五行系统哲学) 2. 核心功能与特色 (10大协作工具) 3. 竞争优势 (同楼优势 × AI × 五行) 4. 发展路线图 (MVP → 社区 → 楼宇生态) 5. 商业模式 (免费社区版 + 企业版) - **用途**: 向投资人、合作方深度介绍 **6. 超协体产品介绍-精简版.md** (4.7K, 3,000字) - **内容**: 电梯演讲版本 - **用途**: 快速向邻居、潜在成员介绍 **7. 超协体产品介绍.html** (18K) - **特色**: - 五行动画效果 - 渐变色视觉设计 - 响应式布局 - **用途**: 浏览器演示、分享链接 **8. 产品介绍文档清单.md** (6.6K) - **作用**: 文档导航中心 - **内容**: 所有产品文档索引 + 使用指南 ### ⭐⭐⭐ 团队协作文档 (3个) **9. 团队成员接入指南.md** (8.4K) - **覆盖场景**: - 场景1: 同一台Mac (测试用) - 场景2: 同楼局域网 (核心场景) - 场景3: 远程接入 (未来扩展) - **完整流程**: 1. 网络连接验证 2. Claude Desktop配置 3. 成员注册 4. 第一个任务测试 **10. 邀请消息.md** (3.8K) - **模板类型**: 微信、面对面、邮件 - **内容**: - 产品价值介绍 - 接入步骤说明 - 常见问题解答 **11. 快速邀请-微信版.txt** (1.1K) - **作用**: 可直接复制的微信消息 - **格式**: 友好、简洁、带emoji ### ⭐⭐⭐ 启动与运维 (4个) **12. start-server.sh** (1.3K) - **功能**: - 自动检测项目路径 - 首次运行自动安装依赖 - 显示本机IP地址 - 使用caffeinate防止Mac休眠 - **使用**: `./start-server.sh` **13. 启动命令.txt** (63字节) - **内容**: `cd ~/ClaudeWorkspace/supercoordination-mcp && ./start-server.sh` - **用途**: 快速复制粘贴启动 **14. 快速启动指南.md** (6.3K) - **启动方式**: - 方法1: 使用启动脚本 (推荐) - 方法2: npm命令 - 方法3: 完整命令路径 - **故障排查**: 端口占用、权限问题、依赖缺失 - **最佳实践**: 后台运行、开机自启 **15. 服务器启动检查清单.md** (4.4K) - **检查项**: - [ ] Node.js版本 (>=16) - [ ] 依赖安装完整 - [ ] 端口3000可用 - [ ] 防火墙配置 - [ ] 局域网可访问 - **用途**: 启动前验证环境 ### ⭐⭐ 技术说明文档 (4个) **16. README.md** (2.8K) - **内容**: - 项目简介 - 快速开始 - 技术架构 - 开发说明 **17. 数据持久化说明.md** (6.2K) - **技术方案**: JSON文件同步写入 - **容量规划**: - 100成员 + 1000任务 = ~500KB - 预估可支持500人规模 - **备份策略**: - 手动备份: `cp data/store.json data/backup/` - 未来: 自动定时备份 - **升级路径**: JSON → SQLite → PostgreSQL **18. 任务列表使用说明.md** (5.1K) ⭐NEW - **功能**: 超协体专用任务列表配置 - **内容**: - 任务列表隔离机制 - 启动脚本自动配置 - 使用方法和验证步骤 - 多项目任务管理最佳实践 - **核心配置**: `CLAUDE_CODE_TASK_LIST_ID=supercoordination` - **用途**: 让超协体任务与其他项目分离管理 **19. test-flow.md** (8.2K) - **测试阶段**: 7个阶段从MVP到多人协作 - **测试内容**: - Stage 1-3: 单人基础功能 - Stage 4-5: 双人协作 - Stage 6-7: 多人调度 - **已完成**: Stage 1-7 全部通过 **20. 项目文档结构.md** (7.6K) - **作用**: 本文档，完整的文档导航 - **内容**: 所有文件分类、用途说明、快速导航 ### 📦 运行时环境 **21. node_modules/** (74个包) - **核心依赖**: - express: HTTP服务器框架 - body-parser: 请求体解析 - **大小**: ~4.3MB - **管理**: 通过package.json自动管理 --- ## 📊 统计信息 - **总文件数**: 20个核心文件 (不含node_modules) - **总代码量**: 747行 (server.js) - **文档总量**: ~10,000+字 (产品介绍) + 6,000字 (技术文档) - **磁盘占用**: 4.5MB (含node_modules) - **项目版本**: v1.2 (任务列表隔离版) ## 🎯 快速导航 ### 我要... **启动服务器** → 看 `start-server.sh` 或 `启动命令.txt` **邀请新成员** → 看 `团队成员接入指南.md` + `邀请消息.md` **介绍产品** → 看 `超协体产品介绍-精简版.md` (3分钟) 或 `.html` (可视化) **深入了解** → 看 `超协体产品介绍.md` (完整版) **技术开发** → 看 `README.md` + `src/server.js` **数据管理** → 看 `数据持久化说明.md` + `data/store.json` **任务列表配置** → 看 `任务列表使用说明.md` ⭐NEW **故障排查** → 看 `快速启动指南.md` (故障排查章节) --- ## 📈 版本演进 - **v1.0** (2026-01-20): - 初始版本 - 3个核心文件: server.js, package.json, .mcp.json - **v1.1** (2026-01-20): - 新增数据持久化 - 新增7个文档: 接入指南、邀请模板、启动脚本等 - **v1.2** (2026-01-21): - 完善产品文档 - 新增13个文档: 产品介绍、HTML可视化、技术说明等 - **v1.3** (2026-01-23): - 新增任务列表隔离功能 - 配置专用任务列表 ID: `supercoordination` - 更新启动脚本 `~/super.sh` - 新增文档: `任务列表使用说明.md` - **当前版本** --- ## 🔮 未来规划 **即将添加**: - [ ] 数据自动备份脚本 - [ ] Web管理界面 (可视化控制台) - [ ] 性能监控仪表盘 - [ ] API文档 (Swagger) **中期计划**: - [ ] 移动端H5界面 - [ ] 数据库升级 (SQLite) - [ ] 用户认证系统 --- *最后更新: 2026-01-23* *当前团队: 1人 (十笔)* *当前任务: 1个* *服务器状态: 运行中 @ 192.168.1.3:3000*