jsboige-mcp-servers

jsboige-mcp-servers

用于扩展大语言模型（LLM）能力的 MCP（Model Context Protocol）服务集合。

CI

• 工作流（.github/workflows/ci.yml）：为 roo-state-manager 执行构建和 vitest
• 分支保护：合并到 main 前，CI 必须通过
• 配置：vitest.config.ts（开发）/ vitest.config.ci.ts（CI，排除 12 个已声明的测试文件条目——统计清单：servers/roo-state-manager/docs/CI-EXCLUSIONS-CENSUS.md）

---

什么是 MCP？

Model Context Protocol（MCP）是一种协议，可让大语言模型（LLM）与外部工具和资源交互。

该协议通过让 LLM 能够访问以下内容，大幅扩展其能力：

• 实时信息搜索
• 访问外部 API
• 文件操作
• 代码分析
• 多 Agent 协调（RooSync）
• 以及更多

仓库内容

此仓库是主项目 roo-extensions 的一个子模块。 MCP 服务位于 servers/ 目录中：

活跃服务

roo-state-manager（主要）

RooSync 多 Agent 系统的核心组件：

• 17 个 MCP 工具，用于多机器协调
• 对话：浏览、查看、树状视图、摘要（Roo + Claude Code）
• RooSync：发送、读取、管理、心跳、compare_config
• 仪表板：全局、机器、工作区（跨机器协调）
• 语义索引：Qdrant + 嵌入（codebase_search、roosync_search）
• 基线：更新、版本、恢复、导出

技术栈：TypeScript、Node.js 20.18.0、Vitest（约 7900 个测试） 文档：servers/roo-state-manager/README.md

sk-agent

面向 Claude Code 和 Roo Code 的 Agent 中心化 LLM 代理服务。

• 多 Agent 对话（DeepSearch、DeepThink）
• 通过 Qdrant 为每个 Agent 提供向量记忆
• 通过 MCP 插件调用工具（SearXNG、Playwright）
• 视觉支持（图像、视频、文档分析）

技术栈：Python、Semantic Kernel、FastMCP 文档：servers/sk-agent/README.md

已移除的服务

已从活跃配置中移除的服务（第 1 个和第 3 个：代码于 09/2026 从 servers/ 中删除，Epic #2639 任务 C）：

• quickfiles-server — 已由 Claude Code 原生功能取代（代码于 09/2026 删除）
• jinavigator-server — 已由 markitdown MCP 取代
• github-projects-mcp — 已由 gh CLI 取代（代码于 09/2026 删除）

---

安装

前提条件

• Node.js 20.18.0（CI 版本）
• npm 10.x 或更高版本
• Git
• Python 3.10+（用于 sk-agent）

快速安装

# Cloner le dépôt (comme submodule)
git clone --recurse-submodules https://github.com/jsboige/roo-extensions.git
cd roo-extensions/mcps/internal

# Installer roo-state-manager
cd servers/roo-state-manager && npm install && npm run build

单独安装

roo-state-manager

cd servers/roo-state-manager
npm install && npm run build
npx vitest run  # NEVER npm test (watch mode blocks)

sk-agent

cd servers/sk-agent
pip install -r requirements.txt
# See servers/sk-agent/README.md for configuration

---

架构

servers/
├── roo-state-manager/   # TypeScript — 17 tools, RooSync core
│   ├── src/tools/       # Tool definitions + handlers
│   ├── src/services/    # Business logic (RooSync, Qdrant, heartbeat)
│   ├── src/resources/   # MCP resources
│   └── tests/           # ~7900 vitest tests
├── sk-agent/            # Python — LLM proxy, multi-agent
│   ├── sk_agent.py      # FastMCP entry point
│   └── sk_conversations.py
└── (retired: quickfiles, jinavigator, github-projects)

---

开发

提交前

1. 构建：npm run build（TypeScript 服务）
2. 测试：npx vitest run（切勿运行 npm test——监视模式会阻塞）
3. CI 配置：npx vitest run --config vitest.config.ci.ts（排除 12 个已声明的测试文件——统计清单：servers/roo-state-manager/docs/CI-EXCLUSIONS-CENSUS.md）

---

贡献

此仓库是 roo-extensions 的一个子模块。

1. 查看未解决的问题
2. 必须提交 PR——不得直接推送到 main
3. 配置环境变量（参见 .env.example）

---

许可证

MIT — 参见 LICENSE

---

Ressources

• Spécification MCP officielle
• Projet parent: roo-extensions
• Issue CI: #626 - Suivi réparation CI