Posuer

🚀 姿势(Posuer)

姿势(Posuer)は、複数のMCP（Multiparty Compute Protocol）サーバーを管理するためのツールです。設定ファイルを通じて複数のMCPサーバーインスタンスを定義して実行でき、コンテナ化サポートと自動検出機能を備え、開発とデプロイのプロセスを簡素化します。

🚀 クイックスタート

姿势(Posuer)は、複数のMCPサーバーを管理するための便利なツールです。以下の手順に従って、開発とデプロイを始めましょう。

✨ 主な機能

• 複数のMCPサーバータイプのサポート：標準入出力(stdio)ベースとストリーミング拡張(sse)ベースのサーバーを含む、さまざまなMCPサーバータイプをサポートします。
• コンテナ構成：各サーバーにコンテナ実行時パラメータを指定でき、より良い分離と依存関係管理を実現します。
• 自動検出：一般的なコマンドを自動で識別し、対応するコンテナ環境を起動できます。
• 設定のホットリロード：姿势(Posuer)を再起動することなく設定ファイルを更新できます。

📦 インストール

姿势(posuer)の開発に必要な依存関係をインストールするには、以下のコマンドを実行します。

npm install

💻 使用例

基本的な使用法

以下は、姿势(posuer)を使用してMCPサーバーを構成する基本的な例です。

サーバー構成

serversは、具体的なサーバー構成または含める必要のある構成ファイルのパスを含む配列です。各サーバー構成項目は、直接定義されたサーバーパラメータでも、文字列として表されるファイルパスでもかまいません。

直接定義するサーバー構成

servers:
  - name: "my-server"
    type: "stdio"
    command: "npx my-app"
    args: []
    env: {}
    url: ""
    enable: []
    disable: []
    container: "node:18-alpine"

上記のサンプルでは、以下のパラメータが定義されています。

• name: サーバー名（名前空間機能に使用）
• type: サーバー接続タイプ（"stdio" または "sse"）
• command: 実行するコマンド（stdio タイプにのみ適用）
• args: コマンドライン引数
• env: 環境変数
• url: サーバーURL（sse タイプにのみ適用）
• enable: 特定の機能を有効にする（下記の形式オプションを参照）
• disable: 特定の機能を無効にする（下記の形式オプションを参照）
• container: コンテナ構成（下記のコンテナオプションを参照）

ファイルを含める

servers:
  - /path/to/server-config.yaml

コンテナ構成

姿势(posuer)は、MCPサーバーのコンテナ構成を3つの異なる形式で指定することをサポートしています。

シンプルな形式

container: "node:18-alpine"

完全な構成

container:
  image: node:18-alpine
  volumes:
    "/data": "/app/data"
  env:
    DB_PATH: "/app/data/database.sqlite"
  network: host
  workdir: "/app"
  args:
    - "--cap-add=SYS_ADMIN"

明示的に無効にする

container: false

高度な使用法

自動コンテナ検出

姿势(posuer)は、特定のコマンドを自動で識別し、適切なコンテナ内で実行することができます。

servers:
  - name: "my-server"
    type: "stdio"
    command: "npx my-app"

上記の例では、npx my-app コマンドが docker.io/node:alpine コンテナ内で自動的に実行されます。

Claude Desktopとの統合

姿势(posuer)は、Claude Desktopと直接統合することをサポートしており、ユーザーがデスクトップ環境でMCPサーバーを管理するのを容易にします。

servers:
  - name: "my-claude-server"
    type: "stdio"
    command: "claude run --port 8080 my-model"

🚧 開発手順

1. 依存関係のインストール

npm install

2. プロジェクトのビルド

npm run build

3. テストの実行

npm test

📄 ライセンス

姿势(posuer)はMITライセンスに従います。詳細な条項については、LICENSE ファイルを参照してください。