MCP Sentinel

MCP インフラストラクチャスイート

Model Context Protocol エコシステムに欠けていたインフラストラクチャ層です。

flowchart LR
    Shared["@oaslananka/shared"]
    Forge["@oaslananka/forge"]
    Sentinel["@oaslananka/sentinel"]
    Atlas["@oaslananka/atlas"]
    Composer["@oaslananka/composer"]
    Bridge["@oaslananka/bridge"]
    Observatory["@oaslananka/observatory"]
    Lab["@oaslananka/lab"]

    Shared --> Forge
    Shared --> Sentinel
    Shared --> Atlas
    Shared --> Composer
    Shared --> Bridge
    Shared --> Observatory
    Shared --> Lab

    Clients["IDE / Agent / SDK clients"] --> Sentinel
    Clients --> Composer
    Composer --> Backends["Backend MCP servers"]
    Sentinel --> Backends
    Forge --> Composer
    Forge --> Sentinel
    Atlas --> Clients
    Observatory --> Sentinel
    Observatory --> Forge
    Lab --> Composer

mcp-suite を選ぶ理由

多くの MCP プロジェクトはサーバーの境界で終わります。mcp-suite は、その周囲にある、より難しい本番環境向けの層、すなわちトランスポート互換性、信頼境界、オーケストレーション、検出、可観測性、運用者のワークフローに重点を置いています。そのため、単一のローカルデモを超えて、チーム、CI、社内プラットフォームで MCP を運用し始める段階で役立ちます。

このスイートは、保護された GitHub ホストのリリース自動化を想定して構築されており、公開可能な各パッケージは @oaslananka スコープで npm に公開できるよう準備されています。モノレポでは、厳格な TypeScript、Turborepo、pnpm、release-please のマニフェスト方式を採用しています。

単発の MCP ユーティリティと比べ、このパッケージ群は連携して使えるように設計されています。shared はプロトコルとランタイムの基盤を定義し、sentinel と composer はトラフィックを制御し、forge は作業をオーケストレーションし、atlas は機能をカタログ化し、bridge はサーバーを生成し、observatory はフィードバックループを完結させ、lab はコントリビューター向けのデスクトップ作業環境を提供します。

パッケージ

パッケージ	機能	ドキュメント
@oaslananka/shared	MCP プロトコル、トランスポート、認証、リトライ、テレメトリー、テスト用プリミティブを共有します	Shared ドキュメント
@oaslananka/forge	MCP ツールと外部ステップをオーケストレーションするパイプラインエンジンです	Forge ドキュメント
@oaslananka/sentinel	監査、承認、PII 制御機能を備えたゼロトラストセキュリティプロキシです	Sentinel ドキュメント
@oaslananka/atlas	MCP サーバーを検出するためのレジストリ API とカタログ UI です	Atlas ドキュメント
@oaslananka/composer	複数のバックエンド MCP サーバーを集約するプロキシです	Composer ドキュメント
@oaslananka/bridge	OpenAPI およびスキーマファースト方式による MCP サーバー生成機能です	Bridge ドキュメント
@oaslananka/observatory	メトリクス、トレース、異常検知、アラート、ダッシュボード UI を提供します	Observatory ドキュメント
@oaslananka/lab	MCP サーバーへの接続とデバッグに使える Electron デスクトップ作業環境です	Lab ドキュメント

MCP Lab のスクリーンショット

ローカルプレイグラウンド

再現可能なデモを試すには、Atlas と Observatory のデータを事前に登録したローカルプレイグラウンドを使用します。

pnpm install --frozen-lockfile
pnpm build
pnpm run playground:seed
pnpm run playground:atlas

次に、別のターミナルで Observatory を起動します。

pnpm run playground:observatory

Atlas は http://localhost:4003、Observatory は http://localhost:4006 で開きます。Lab は pnpm --filter @oaslananka/lab dev で起動します。手順の詳細はローカルプレイグラウンドガイドをご覧ください。

クイックスタート

pnpm install --frozen-lockfile
pnpm build

# Seed and run Atlas
pnpm --filter @oaslananka/atlas exec node dist/cli.js seed --db ./data/atlas.sqlite
pnpm --filter @oaslananka/atlas exec node dist/cli.js serve --db ./data/atlas.sqlite --port 4003

# In another terminal, run Observatory
pnpm --filter @oaslananka/observatory exec node dist/cli.js serve --db ./data/observatory.sqlite --port 4006

サービスの起動後、次の URL にアクセスできます。

• Atlas UI：http://localhost:4003
• Atlas ヘルスチェック：http://localhost:4003/health
• Observatory UI：http://localhost:4006
• Observatory ヘルスチェック：http://localhost:4006/health

アーキテクチャ

shared は、他のすべてのコンポーネントで使われるプロトコルの基盤、ロガーファクトリー、トランスポート、テレメトリーヘルパー、テストフィクスチャを提供します。MCP クライアント向けのトラフィックは通常、ポリシー適用と監査のために sentinel でラップされ、その後 composer を通じて集約されるか、forge からオーケストレーションされます。atlas と observatory は HTTP を中心とした運用者向けのインターフェースであり、lab は開発者向けのデスクトップエントリーポイントです。

現在、このスイートでは MCP プロトコルバージョン 2025-11-25 がデフォルトですが、1.0 への移行期間中は 2025-11-05 のハンドシェイク用の互換性ヘルパーも維持しています。

アーキテクチャ上の決定はADR インデックスに記録されています。

開発

make install
pnpm run format:check
make lint
make typecheck
make test
pnpm run security
make test-coverage
make knip
pnpm run release:dry-run

セットアップとワークフローの詳細については、docs/development.md、docs/testing.md、docs/security.md、docs/release.md、生成された API リファレンスのパスを記載した docs/api-reference.md、および docs/guide 以下のガイドドキュメントをご覧ください。

リリースポリシー

• バージョンの更新、変更履歴、タグ、GitHub リリースは、release-please のマニフェストモードで管理します。
• GitHub Actions は、クリーンなチェックアウト状態から npm パッケージの tarball、機械可読なリリースマニフェスト、SBOM、チェックサム、証明書をビルドします。
• npm への本番公開は、環境で保護された別のプロセスで行い、チェックサム、証明書、パッケージ内容、クリーンインストールの検証後に、npm の信頼された公開／OIDC を使用します。
• npm の一部公開は再開可能です。同一で不変のバージョンはスキップし、不足しているバージョンは依存関係の順序に従って公開し、整合性の競合が発生した場合は処理を中止します。
• ドキュメントのみ、内部のみ、CI のみの変更では、npm への公開やレジストリメタデータの更新は行いません。

コントリビューション

コントリビューションを歓迎します。まず CONTRIBUTING.md をご確認ください。ユーザーに見える変更には Conventional Commits を使用し、検証手順を追加する際は GitHub Actions との同等性を保ってください。 課題のトリアージ、サポート、古い課題の処理、ラベル、メンテナーの応答目標については、docs/governance.md をご覧ください。

ロードマップ

• @oaslananka/gateway：HTTP を中心としたマルチテナント MCP ゲートウェイ
• @oaslananka/sdk：Python から始めるクロスランゲージ SDK
• React Flow を基盤とする Forge ビジュアルエディター
• 複数のレジストリーインスタンスにまたがる Atlas フェデレーション
• Grafana および OTel コレクターパイプライン向けの Observatory エクスポート
• OPA との Sentinel ポリシー統合

ライセンス

Apache 2.0 — © 2025-2026 oaslananka