MCP Sync Server

MCP同步服务器

面向生产的MCP服务器，用于本地/边缘AI工作流：工具路由、队列执行、任务图操作和同步端点。

建筑

flowchart LR
  A[Windsurf VSIX / Client] --> B[MCP Sync Server]
  B --> C[Tool Router + Policy]
  C --> D[Queue + Workers]
  D --> E[LabBrain / AutoGen Runtime]
  E --> F[Reports + Evidence JSON]

快速演示

cd C:\Users\anani\Projects\mcp-sync-server
npm ci
npm run build
npm start

然后验证：

Invoke-RestMethod http://127.0.0.1:3000/health

服务器默认值：

• 网址： http://127.0.0.1:3000
• 健康： GET /health
• MCP： /mcp

构建和测试

npm run build
npm test

CI(.github/workflows/ci.yml)运行：

1. npm ci
2. npm run build
3. npm test
4. 构建工件检查(dist/index.js)

分析快照

报告工件示例：

• _sync/autogen_learning/quality_tick_latest.json
• _sync/external_analysis/hook_probe_latest.json
• _sync/external_analysis/security_mode_latest.json

特征矩阵

商业就绪

为飞行员推荐的KPI目标：

• AUTH_ENABLED:

- true|1|on|enabled：强制授权 - false|0|off|disabled：强制关闭身份验证（仅限开发人员） - 空：自动模式（设置令牌时启用）

启用身份验证时受保护的路由：

• /mcp
• /messages
• /sse
• /sse-simple

发展

npm run dev

安全

看 SECURITY.md 用于漏洞报告和令牌卫生要求。

测试布局

根级测试脚本已移至 tests/ 保持存储库根目录干净。

商业设置（变体1）

1. 生成一个强大的承载令牌。
2. 集 AUTH_ENABLED=true.
3. 集 MCP_ALLOWED_ROOTS 到客户端存储库根目录。
4. 集 MCP_ALLOWED_ORIGINS 到客户端域+localhost。
5. 在发布之前运行安全/令牌检查。

报价：MCP+安全门飞行员（48小时）

可交付成果：

• 目标仓库/服务的MCP工作流程。
• 安全+质量证据报告（JSON+简短摘要）。
• 包含补救优先级和发布关卡判决的运行手册。

典型的试点目标：

• 降低释放风险，
• 及早发现关键的安全配置错误，
• 先执行证据。

联系/预订飞行员

• GitHub问题：

- 飞行员： .github/ISSUE_TEMPLATE/pilot_request.md - 程序错误 .github/ISSUE_TEMPLATE/bug_report.md - 特点： .github/ISSUE_TEMPLATE/feature_request.md

• 电子邮件： your-email@domain.com
• 可选录取模板：

- 目标存储库/服务 - 堆栈（节点/Python等） - 规定的截止日期 - 合规性/安全约束 - 预期结果（GO/NO-GO、报告、补救计划）

参与者启动任务：

• docs/roadmap/GOOD_FIRST_TASKS.md

启动资产：

• docs/marketing/LAUNCH_DAY_CHECKLIST.md
• docs/marketing/POST_PACK_WEEK1.md
• docs/marketing/DAY2_POST_PACK.md
• docs/marketing/LEADS_TRACKER_TEMPLATE.csv
• ops/marketing/new_weekly_report.ps1

许可证

麻省理工学院-见 LICENSE.