🍠 YAMCP - A Model Context Workspace Manager

🍠 YAMCP - モデルコンテキストワークスペースマネージャー

YAMCP（YAM-C-P）は、MCP サーバーをローカルワークスペースとして整理、管理するためのコマンドラインツールです。複数のMCPサーバー（ローカルまたはリモートサーバー）にシームレスに接続し、それらを統合ワークスペースにまとめ、AIアプリケーション向けにYet Another MCPサーバー（YAM）として公開します。特定の機能に基づいた専用ワークスペース（例：コーディング、デザイン、リサーチ向けのYAMワークスペース）、サーバーを利用するAIアプリに基づいたワークスペース（例：Cursor、Claude、Windsurf向けのYAM）、またはその中間のあらゆる組み合わせを作成できます。さらに、すべてのサーバー通信ログを単一のストアに集約することで、MCPサーバーの監視とデバッグを簡素化し、各AIクライアントアプリのログを個別に調べる必要をなくします。

ワークスペースのインポートと作成

1つの設定ですべてのバンドル済みサーバーをワークスペース内でAIアプリに接続

🚀 クイックスタート

# Install YAMCP
npm install -g yamcp  # or use npx yamcp

# Import servers (choose one)
yamcp server import [config]    # import servers from config file (see src/example-servers.json for format)
yamcp server add                # or add manually

# create workspaces (e.g. a yam for coding, design, data, ...)
yamcp yam create

# Run workspace in your AI app
yamcp run <yam-workspace-name>

🔑 主な概念

• MCPサーバー：Model Context Protocolサービスを提供するリモートまたはローカルのサーバー
• ワークスペース（YAM）：AIアプリと共有するためにまとめられたMCPサーバーのコレクション（例：コーディング、ライティング、デザイン、魔法づくり向けのワークスペース）
• ゲートウェイ：ワークスペース内の設定済みMCPサーバーへの接続を管理し、それらを統合サーバー経由でAIアプリのMCPクライアントに公開するローカルMCPサーバー

YAMCPでは、次のことができます。

• AIアプリ（例：Cursor、Claude、GitHub Copilot）ごとにMCPサーバーをまとめたワークスペースを作成する
• ワークフローの目的（例：ソフトウェア開発、データサイエンス、テクニカルライティング）ごとにサーバーをまとめる
• すべてのワークスペースサーバーにアクセスできる単一のゲートウェイにAIアプリを接続する
• 統合インターフェースを通じて、複数のMCPサーバー接続を管理、監視する
• 詳細なログ記録とデバッグ機能を使って、すべてのサーバー通信を追跡する

トップレベルコマンド

yamcp [command] [subcommand] [flags]

利用可能なトップレベルコマンド：

• server - MCPプロバイダーを管理します
• yam - ワークスペース（YAM）を管理します
• run - ワークスペースを指定してゲートウェイを実行します
• log - サーバーログの場所を表示します

---

🔧 MCPサーバー管理コマンド

サーバーコマンド

yamcp server add      # Add a new MCP server (interactive)
yamcp server list     # List all configured servers and their status
yamcp server remove   # Remove a server configuration
yamcp server import   # Import server configurations from a JSON file

---

🍠 YAMワークスペース管理コマンド

ワークスペースコマンド

yamcp yam create      # Create a new workspace (interactive)
yamcp yam list        # List all workspaces or show specific workspace details
yamcp yam edit        # Modify an existing workspace configuration
yamcp yam scan            # Scan workspaces
yamcp yam delete          # Delete a workspace

ランタイムコマンド

yamcp run <yam-workspace-name>   # Start the gateway with specified workspace
yamcp log                    # View server communication logs

---

✅ コマンドリファレンス

コマンド	説明	例
server add	新しいMCPサーバーを追加する	yamcp server add
server list	設定済みサーバーを一覧表示する	yamcp server list
server remove	サーバーを削除する	yamcp server remove [name]
server import	サーバー設定をインポートする	yamcp server import [config]
yam create	ワークスペースを作成する	yamcp yam create
yam list	ワークスペースを一覧表示する	yamcp yam list
yam list --name	ワークスペースの詳細を表示する	yamcp yam list --name my-workspace
yam edit	ワークスペースを編集する	yamcp yam edit
yam scan	ワークスペースをスキャンする	yamcp yam scan [workspace-name]
yam delete	ワークスペースを削除する	yamcp yam delete [workspace-name]
run	ゲートウェイを起動する	yamcp run <workspace-name>
log	ログを表示する	yamcp log

---

🖥️ YAMCP UI（@eladcandroid が作成）

YAMCP UI は、統合ダッシュボードを通じて MCP サーバーとワークスペースを管理できる、直感的なウェブインターフェースを提供します。

# Run directly with npx (recommended)
npx yamcp-ui

# Or install globally
npm install -g yamcp-ui
yamcp-ui

詳細なドキュメントについては、プロジェクトのリポジトリを参照してください：https://github.com/eladcandroid/yamcp-ui.

🏗️ システムアーキテクチャ

graph TB
    CLI[CLI Commands]
    GW[McpGateway]
    GS[GatewayServer]
    GR[GatewayRouter]
    LOG[Logger]
    STORE[(Store)]
    AI_APP[AI App]

    %% CLI Command Flow
    CLI -->|manages| STORE
    CLI -->|runs| GW

    %% Gateway Components
    GW -->|uses| GS
    GW -->|uses| GR
    GW -->|logs| LOG

    %% Server & Router
    GS -->|stdio transport| AI_APP
    GR -->|connects to| SERVERX
    GR -->|connects to| SERVERY

    %% Data Store
    STORE -->|loads config| GW

    %% External MCP Servers
    subgraph "Workspace Servers"
        SERVERX["Server x (Stdio)"]
        SERVERY["Server y (SSE)"]
    end
    %% Store Components
    subgraph "Configuration Store"
        PROVIDERS[(Provider Config)]
        WORKSPACES[(Workspace Config)]
    end
    STORE --- PROVIDERS
    STORE --- WORKSPACES

    classDef primary fill:#2374ab,stroke:#2374ab,color:#fff
    classDef secondary fill:#ff7e67,stroke:#ff7e67,color:#fff
    classDef store fill:#95b8d1,stroke:#95b8d1,color:#fff

    class GW,GS,GR primary
    class CLI,AI_APP secondary
    class STORE,PROVIDERS,WORKSPACES store

図は、YAMCP システムの主なコンポーネントを示しています。

• CLI Commands：サーバーとワークスペースを管理するユーザーインターフェース
• McpGateway：Gateway Server と Router を連携させる中核コンポーネント
• GatewayServer：stdio トランスポートを介して AI アプリとの通信を処理します
• GatewayRouter：設定済みの MCP サーバーへの接続を管理します
• Logger：すべてのコンポーネントのログを一元管理します
• Store：プロバイダーとワークスペースの設定を管理します
• MCP Servers：MCP サービスを提供するローカル（stdio）サーバーとリモート（SSE）サーバー

🪪 セキュリティ監査