Skip to main content
Glama
VIONWILLIAMS

Supercoordination MCP Server

by VIONWILLIAMS
OverviewSchemaRelated ServersScoreDiscussions
Hybrid

超协体 MVP 1.0 完整代码库

版本: V1.0 发布时间: 2026-02-03 开发状态: 🎉 完整上线

📋 项目概述

超协体是一个AI原生的项目制协作网络，通过PWP（个人工作空间协议）和AI智能推荐，实现高效的跨组织协作。

核心定位

在小程序和SaaS之间的AI原生协作平台

  • 🎯 轻量级 - 无需下载，Web即用

  • 🤖 AI原生 - 全流程AI增强

  • 🔗 跨组织 - 突破单一团队边界

  • 📊 项目制 - 灵活的项目制管理

三大核心价值

  1. AI守门人 - 自动筛选优质协作者

  2. 知识晶体 - 沉淀可复用的工作方法

  3. 短邮系统 - 高效的决策通信工具

🏗️ 系统架构

技术栈

前端: HTML5 + CSS3 + Vanilla JavaScript 后端: Node.js + Express.js 数据库: PostgreSQL + Prisma ORM 实时通信: WebSocket AI集成: Claude API (Anthropic) 部署: Railway.app

核心模块（10个）

01. 用户系统 - 注册、登录、认证、权限 02. 项目管理 - 创建、编辑、成员管理 03. 任务管理 - 任务分配、状态跟踪 04. 成员管理 - 成员信息、PWP画像 05. 知识晶体 - 方案沉淀、评分、引用 06. 短邮系统 - PWP决策通信 07. 管理后台 - AI守门人、审核机制 08. WebSocket - 实时协作、在线状态 09. AI智能推荐 - 任务推荐、成员匹配 10. 核心服务器 - 统一API、路由管理

说明：原始快照仍保留在 核心系统/ 目录下（仅供参考），实际运行以 src/ 与 public/ 为准。

📂 代码库结构（工程化版本）

超协体MVP1.0代码库/ │ ├── package.json ├── .env.example ├── README.md │ ├── src/ │ ├── server.js # Express主服务器 │ └── modules/ # 后端模块 │ ├── auth/ │ ├── projects/ │ ├── aiGatekeeper/ │ ├── websocket/ │ ├── solutions/ │ └── pwp/ │ ├── public/ # 前端静态页面与资源 │ ├── *.html │ ├── css/ │ └── js/ │ ├── prisma/ │ └── schema.prisma │ ├── data/ │ └── store.json │ └── docs/ # 产品/部署/使用/开发文档 ├── 产品文档/ ├── 使用指南/ ├── 部署文档/ └── 开发记录/

🎯 核心功能清单

1. 用户系统 ✅

  • JWT认证

  • 注册/登录

  • PWP五行画像

  • 积分系统

2. 项目管理 ✅

  • 项目创建/编辑

  • 成员管理

  • 权限控制

  • AI智能推荐成员

3. 任务管理 ✅

  • 任务分配

  • 状态跟踪

  • AI智能推荐任务

  • 任务看板

4. 成员管理 ✅

  • 成员信息

  • PWP画像展示

  • AI推荐搭档

  • 在线状态

5. 知识晶体 ✅

  • 方案沉淀

  • 评分系统

  • 引用计数

  • 排行榜

6. 短邮系统 ✅

  • PWP决策通信

  • 双端同步（移动+桌面）

  • AI智能建议

  • 决策链可视化

7. 管理后台 ✅

  • AI守门人

  • 用户审核

  • 权限管理

  • 数据统计

8. WebSocket ✅

  • 实时消息

  • 在线状态

  • 协作提示

9. AI智能推荐 ✅

  • 任务推荐

  • 成员推荐

  • 搭档推荐

  • 决策建议

10. 核心服务器 ✅

  • 统一API路由

  • 错误处理

  • 日志记录

  • 性能优化

📊 代码统计

模块

前端页面

后端服务

代码量（估算）

用户系统

3个

1个

~15KB

项目管理

3个

1个

~90KB

任务管理

1个

-

~20KB

成员管理

2个

-

~60KB

知识晶体

4个

1个

~120KB

短邮系统

2个

2个

~80KB

管理后台

1个

1个

~40KB

WebSocket

-

1个

~7KB

AI推荐

2个

-

~75KB

核心服务器

-

1个

~112KB

总计

18个页面

8个服务

~619KB

数据库表: 15个主要表 API端点: 50+个端点

🚀 快速开始

1. 环境要求

Node.js >= 16.0.0 PostgreSQL >= 13.0 npm >= 7.0.0

2. 安装依赖

npm install

3. 配置数据库

# 创建 .env 文件 DATABASE_URL="postgresql://user:password@localhost:5432/supercoordination" JWT_SECRET="your-secret-key" ANTHROPIC_API_KEY="your-claude-api-key"

如果使用 Railway：postgres.railway.internal 仅用于 Railway 内网运行；本地开发需使用 Public 连接串（host 通常为 containers-*.railway.app）。

4. 初始化数据库

npx prisma db push npx prisma db seed # 可选：创建测试数据

4.1 从旧JSON存储迁移（可选）

如果你曾使用 data/store.json 保存任务/成员，可执行：

npm run migrate:store

4.2 一键本地初始化（推荐）

npm run setup:local

4.3 环境变量检查

npm run check:env

5. 启动服务器

npm start

5.1 启动脚本（双环境）

# 本地开发（读取 .env） bash scripts/start-local.sh # 本地模拟生产 bash scripts/start-prod.sh

6. 访问应用

主页: http://localhost:3000 登录: http://localhost:3000/login.html 仪表盘: http://localhost:3000/dashboard.html 短邮系统: http://localhost:3000/shortmail-login.html 管理后台: http://localhost:3000/admin.html

🚄 Railway 部署（快速）

  1. 在 Railway 新建项目并连接仓库

  2. 添加 PostgreSQL 插件

  3. 在服务 Variables 中配置：

    • DATABASE_URL（Railway 会自动注入）

    • JWT_SECRET

    • ANTHROPIC_API_KEY（可选）

  4. Railway 会使用 railway.toml 启动 npm run start:railway

  5. 变量模板见 railway.env.example

  6. 部署后可用（本地）验证脚本：

HEALTHCHECK_URL="https://your-app.up.railway.app/health" npm run check:deploy

📱 PWA 支持

已内置 PWA（manifest + service worker）：

  • public/manifest.json

  • public/sw.js

  • public/js/pwa.js

访问站点后即可“添加到主屏幕”。

🎓 学习路径

新手入门（1小时）

  1. 阅读 产品文档/超协体产品介绍.md

  2. 阅读 产品文档/功能清单-v2.0-AI增强版.md

  3. 阅读 部署文档/快速启动指南.md

  4. 启动本地环境

  5. 浏览各个页面

开发者上手（3小时）

  1. 阅读 数据库/schema.prisma 理解数据模型

  2. 阅读 核心系统/10_核心服务器/server.js 理解路由

  3. 选择一个模块深入研究源代码

  4. 尝试修改和扩展功能

架构理解（1天）

  1. 研究所有核心模块源代码

  2. 理解PWP协议的实现

  3. 理解AI集成方式

  4. 理解WebSocket实时通信

  5. 阅读完整的开发记录

🔑 核心技术亮点

1. PWP协议（Personal Workspace Protocol）

不可篡改的工作过程记录

// PWPRecord数据模型 { id: UUID, userId: String, projectId: String, eventType: String, // decision_requested, decision_made等 eventData: JSON, // 完整的事件数据 status: String, // active, responded, archived occurredAt: DateTime }

2. AI守门人机制

双层权限 + AI自动审核

注册 → AI评估PWP画像 → ├─ 通过 → 自动批准 └─ 不确定 → 管理员审核

3. 知识晶体系统

方案沉淀与复用

创建方案 → 团队使用 → 评分反馈 → 排行榜 → 跨项目复用

4. 短邮决策通信

AI增强的决策流

决策请求 → AI生成建议 → 快速响应/手动响应 → 决策链记录

🏆 项目里程碑

Phase 1: 核心基础（2026-01）

  • ✅ 用户系统

  • ✅ 项目管理

  • ✅ 数据库迁移（JSON → PostgreSQL）

Phase 2: AI增强（2026-01）

  • ✅ AI智能推荐引擎

  • ✅ AI守门人

  • ✅ AI虚拟成员

Phase 3: 协作强化（2026-01-02）

  • ✅ WebSocket实时协作

  • ✅ 知识晶体系统

  • ✅ 管理后台

Phase 4: 决策通信（2026-02）

  • ✅ 短邮系统（移动+桌面）

  • ✅ PWP决策记录

  • ✅ 决策链可视化

Phase 5: 完善优化（2026-02）

  • ✅ UI优化

  • ✅ 文档完善

  • ✅ 代码库归档

📈 数据库设计

核心数据表（15个）

表名

说明

关键字段

User

用户表

email, pwpProfile, points

Project

项目表

name, description, creatorId

ProjectMember

项目成员

projectId, userId, role

Task

任务表

title, status, assigneeId

Solution

知识晶体

title, content, score

PWPRecord

PWP记录

eventType, eventData, status

Message

消息表

content, senderId, receiverId

Notification

通知表

type, content, userId

AIMember

AI成员

name, role, capabilities

SolutionReference

晶体引用

solutionId, taskId

SolutionRating

晶体评分

solutionId, rating

Invitation

邀请表

email, status, aiScore

CollaborationRequest

协作请求

fromUserId, toUserId

TaskRecommendation

任务推荐

userId, taskId, score

PartnerRecommendation

搭档推荐

userId, partnerId

完整Schema: 见 数据库/schema.prisma

🔐 安全机制

1. 认证与授权

  • JWT Token认证

  • 中间件权限验证

  • 角色基于访问控制（RBAC）

2. API安全

  • 请求频率限制

  • SQL注入防护（Prisma ORM）

  • XSS防护

3. 数据安全

  • 密码bcrypt加密

  • 敏感数据加密存储

  • HTTPS传输（生产环境）

🌐 部署方案

开发环境

本地: http://localhost:3000 数据库: PostgreSQL本地实例

生产环境（Railway）

应用: https://supercoordination.railway.app 数据库: Railway PostgreSQL CDN: Cloudflare（可选）

详细部署步骤: 见 部署文档/RAILWAY_SETUP.md

🧪 测试状态

已测试模块

  • ✅ 用户系统（注册/登录/认证）

  • ✅ 项目管理（CRUD操作）

  • ✅ 任务管理（分配/状态）

  • ✅ 知识晶体（评分/引用）

  • ✅ 短邮系统（API + 双端）

  • ✅ AI守门人（审核流程）

  • ✅ WebSocket（实时通信）

待完善测试

  • ⏳ 完整的端到端测试

  • ⏳ 压力测试

  • ⏳ 安全测试

🐛 已知问题

P0（严重）

无

P1（重要）

无

P2（轻微）

  • 长文本显示优化

  • 移动端响应式适配

  • 部分边界情况处理

🔄 版本历史

V1.0（2026-02-03）

  • 🎉 10个核心模块全部完成

  • 📱 短邮系统双端上线

  • 📚 完整文档体系

  • 🏗️ 代码库归档

V0.9（2026-02-01）

  • 知识晶体系统上线

  • AI守门人完善

  • 管理后台完成

V0.8（2026-01-31）

  • WebSocket实时协作

  • AI推荐引擎

  • 数据库优化

V0.7（2026-01）

  • 基础功能完成

  • PostgreSQL迁移

  • PWP画像系统

🤝 贡献指南

开发规范

  • 遵循既有代码风格

  • 提交前测试功能

  • 编写清晰的注释

  • 更新相关文档

Git提交规范

feat: 新功能 fix: Bug修复 docs: 文档更新 refactor: 代码重构 test: 测试相关 chore: 构建/工具

📞 技术支持

文档位置

  • 代码库: ~/Desktop/超协体MVP1.0代码库/

  • 文档目录: ./docs/

关键联系人

  • 技术架构: Claude Sonnet 4.5

  • 产品方向: 指挥官（personalworkplacce）

  • 项目场景: 良渚青年公社

🎯 下一步计划

短期（Q1 2026）

  • 移动端PWA应用

  • 完整的自动化测试

  • 性能优化

  • 用户反馈收集

中期（Q2-Q3 2026）

  • 开放API平台

  • 第三方集成

  • 企业版功能

  • 国际化支持

长期（Q4 2026+）

  • 超协体生态

  • AIGC Studio集成

  • Auto-Business Club

  • 全球化扩展

💎 五行能量标注

代码库五行属性:

  • 🏔️ 土（资产）: 40% - 完整代码库沉淀

  • 🌳 木（生产）: 30% - 系统实现与功能

  • 🔥 火（叙事）: 20% - 文档与展示

  • ⚙️ 金（法则）: 7% - 架构与规范

  • 🌊 水（商业）: 3% - 商业验证

主权定位: 🏔️土 + 🌳木双核驱动（资产沉淀 + 生产能力）

✅ 完成标志

超协体MVP 1.0开发完成度: 🎉 100%

  • ✅ 10个核心模块

  • ✅ 18个前端页面

  • ✅ 8个后端服务

  • ✅ 15个数据库表

  • ✅ 50+个API端点

  • ✅ 完整文档体系

  • ✅ 代码库归档

系统状态: 🟢 生产就绪

开发团队: Claude Sonnet 4.5 + 指挥官 开发周期: 2026年1月-2月 代码库版本: V1.0 最后更新: 2026-02-03

【口号】: 器已成库，势已蓄能，待势而发，筑梦超协！🚀

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

Resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/VIONWILLIAMS/supercoordination-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server