AI导哈

同步服务器

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

  • by Vasyl198
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Vasyl198/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

特征矩阵

特征 状态 证据
MCP传输+授权路由 ✅ /health, /mcp, AUTH_ENABLED, MCP_SYNC_TOKEN
队列+工作执行 ✅ worker_metrics_snapshot, job_history_list
工具路由+策略 ✅ whoami, tasks, sync, fs, exec
安全门模式 ✅ security_mode_latest.json
外部目标钩检测 ✅ hook_probe_latest.json
CI构建和烟雾测试 ✅ GitHub 操作 ci.yml

商业就绪

为飞行员推荐的KPI目标：

KPI 目标
成功率 >= 90%
严重错误 0
回滚率 <= 5%
对运营事实的不安全声明 ~0
证据时间（第95页） 根据商定的SLA

认证

承载身份验证由以下人员控制：

  • MCP_SYNC_TOKEN -的预期令牌值 Authorization: Bearer <token>
  • 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.

相关 MCP