MCP Host CLI

🚀 mcp-host-use

mcp-host-use は Node.js ベースの Model Context Protocol (MCP) ホストアプリケーションで、複数の MCP サーバーを接続および管理するために使用されます。Host は統一されたインターフェースを提供し、クライアントが HTTP API を介して複数の MCP サーバーとやり取りし、ツール（またはリソース）にアクセスおよび呼び出すことを可能にします。

🚀 クイックスタート

mcp-host-use は、Node.js ベースのアプリケーションで、複数の MCP サーバーを接続および管理するために使用されます。以下に使用方法を説明します。

一、npm パッケージを使用する方法：

npm install -g mcp-host-use
mcp-host-use --start

二、ローカルでビルドして実行する方法：

git clone [リポジトリのURL]
cd mcp-hostuse
npm install
node index.js

✨ 主な機能

1. 複数の MCP サーバー接続のサポート：
   複数の MCP サーバーを同時に接続および管理でき、設定ファイルを通じて動的に拡張できます。

2. 複数のデータ転送方式：

   • STDIO 通信： 標準入出力を介した外部プロセスとのやり取りをサポートします。
   • Server-Sent Events (SSE)： リアルタイムイベントのプッシュをサポートしています。

3. 統一された HTTP API インターフェース：
   以下の機能を提供します：

   • すべてのツールリストを取得する
   • 特定のツールを呼び出す
   • すべてのリソース情報を取得する
   • 特定のリソースの内容を読み取る
   • サーバー接続設定を更新する

📦 インストール

環境要件

• Node.js: Node.js をインストールする必要があります（推奨バージョンは v14 以上）
• npx: npx ツールをグローバルにインストールすることをおすすめします
• uvx: UVX プロトコルを使用する場合は、事前に Python 環境をインストールする必要があります

インストール手順

一、npm パッケージを使用する方法：

npm install -g mcp-host-use
mcp-host-use --start

二、ローカルでビルドして実行する方法：

git clone [リポジトリのURL]
cd mcp-hostuse
npm install
node index.js

📚 ドキュメント

プロジェクトアーキテクチャ

graph TD
    A[クライアント] --> B[HTTP API]
    B --> C[MCP Host]
    C --> D[複数の MCP サーバー接続]

プロジェクト構造

mcp-host-use/
├── index.js          # メインプログラムのエントリーポイント
├── config.js        # 設定ファイルの管理
├── connections.js   # MCP サーバー接続の管理
├── tools.js         # ツールインターフェースの実装
└── resources.js     # リソース管理モジュール

設定ファイル

設定ファイルのパス： config/servers.json

JSON 形式の例：

[
    {
        "name": "server1",
        "type": "stdio",  # または 'sse'
        "command": "node server.js"
    },
    {
        "name": "server2",
        "type": "sse",
        "url": "http://localhost:3000"
    }
]

注意事項

1. デフォルトポート：
   サービスはデフォルトで 17925 ポートで実行され、設定ファイルで変更できます。

2. 設定ファイルの場所：
   設定ファイルはプロジェクトのルートディレクトリの config/servers.json ファイルにあります。

3. 実行コマンドの要件：

   • stdio タイプを使用する場合は、対象プロセスが標準入出力通信をサポートしていることを確認してください。
   • SSE タイプを使用する場合は、対象サーバーが Server-Sent Events プロトコルを正しく実装していることを確認してください。

API ドキュメント

一、すべてのツールリストを取得する

GET http://localhost:17925/api/tools

応答例：

{
  "code": 0,
  "data": [
    {
      "server_name": "サーバー1",
      "tools": [
        {
          "name": "ツール名",
          "description": "ツールの説明",
          "inputSchema": { ... }
        }
      ]
    }
  ]
}

二、特定のツールを呼び出す

POST http://localhost:17925/api/tools/toolCall
Content-Type: application/json

{
  "server_name": "サーバー名",
  "tool_name": "ツール名", 
  "tool_args": { ... }
}

応答例：

{
  "code": 0,
  "data": {
    "result": "ツールの実行結果"
  }
}

三、すべてのリソース情報を取得する

GET http://localhost:17925/api/resources

応答例：

{
  "code": 0,
  "data": [
    {
      "server_name": "サーバー1",
      "resources": [
        {
          "uri": "リソースのURI",
          "mimeType": "リソースのタイプ",
          "name": "リソース名"
        }
      ]
    }
  ]
}

四、特定のリソースの内容を読み取る

POST http://localhost:17925/api/resources/read
Content-Type: application/json

{
  "server_name": "サーバー名",
  "resource_uri": "リソースのURI"
}

応答例：

{
  "code": 0,
  "data":  [
    {
      "content": "...", 
      "mimeType": "text/plain"
    }
  ]
}

五、サーバー接続設定を更新する

POST http://localhost:17925/api/connections/update
Content-Type: application/json

{
  "server_name": "対象サーバー名",
  "new_config": {
    # 新しいサーバー設定情報
  }
}

📄 ライセンス

[TODO: ライセンス情報を追加する]

貢献者

[TODO: 貢献者リストを追加する]