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 へのアクセス
• ファイルの操作
• コードの分析
• マルチエージェントの連携（RooSync）
• その他多数

リポジトリの内容

このリポジトリは、メインプロジェクト roo-extensions のサブモジュールです。 MCP サーバーは servers/ ディレクトリに配置されています。

アクティブなサーバー

roo-state-manager（メイン）

RooSync マルチエージェントシステムの中心的なコンポーネントです。

• 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 向けのエージェント中心型 LLM プロキシサーバーです。

• マルチエージェントの会話（DeepSearch、DeepThink）
• Qdrant によるエージェントごとのベクトルメモリ
• MCP プラグイン（SearXNG、Playwright）を介したツール呼び出し
• ビジョン対応（画像、動画、ドキュメントの分析）

技術スタック：Python、Semantic Kernel、FastMCP ドキュメント：servers/sk-agent/README.md

廃止されたサーバー

アクティブな設定から削除されたサーバー（1 番目と 3 番目：2026 年 9 月に servers/ からコードを削除、Epic #2639 タスク C）：

• quickfiles-server — Claude Code のネイティブ機能に置き換え済み（コードは 2026 年 9 月に削除）
• jinavigator-server — markitdown MCP に置き換え済み
• github-projects-mcp — gh CLI に置き換え済み（コードは 2026 年 9 月に削除）

---

インストール

前提条件

• 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. オープン中の issueを確認します
2. PR は必須です — main に直接 push しないでください
3. 環境変数を設定します（.env.example を参照）

---

ライセンス

MIT — LICENSE を参照

---

Ressources

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