Posuer

🚀 姿勢(Posuer)

姿勢(Posuer)是一款用於管理多個MCP（Multiparty Compute Protocol）服務器的實用工具。它允許用戶通過配置文件定義並運行多個MCP服務器實例，同時提供容器化支持與自動檢測功能，極大地簡化了MCP服務器的開發與部署流程。

🚀 快速開始

姿勢(Posuer)能讓你輕鬆管理多個MCP服務器。通過配置文件，你可以快速定義和運行服務器實例，還能利用其容器化和自動檢測功能，簡化開發與部署工作。

✨ 主要特性

• 支持多種MCP服務器類型：涵蓋基於標準輸入輸出(stdio)和基於流式擴展(sse)的服務器。
• 容器配置：可為每個服務器指定容器運行時參數，實現更優的隔離和依賴管理。
• 自動檢測：能自動識別常見命令，並啟動相應的容器環境。
• 配置熱重載：支持在不重啟姿勢(Posuer)的情況下更新配置文件。

📦 安裝指南

姿勢(Posuer)的開發流程如下：

1. 安裝依賴：

npm install

2. 構建項目：

npm run build

3. 運行測試：

npm test

📚 詳細文檔

服務器配置

servers是一個數組，包含具體的服務器配置或需要包含的配置文件路徑。每個服務器配置項可以是直接定義的服務器參數，也可以是一個字符串表示的文件路徑。

直接定義服務器配置

• name：服務器名稱（用於命名空間能力）
• type：服務器連接類型（"stdio" 或 "sse"）
• command：要運行的命令（僅適用於 stdio 類型）
• args：命令行參數
• env：環境變量
• url：服務器 URL（僅適用於 sse 類型）
• enable：啟用特定功能（請參閱格式選項下方）
• disable：禁用特定功能（請參閱格式選項下方）
• container：容器配置（請參閱容器選項下方）

包含文件

只需提供文件路徑作為字符串即可：

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

容器配置

姿勢(Posuer)支持在三個不同的格式中指定MCP服務器的容器配置：

1. 簡單格式：僅指定鏡像名稱：

container: "node:18-alpine"

2. 完整配置：提供一個包含所有容器選項的地圖：

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"

3. 顯式禁用：設置為 false 以禁用容器隔離，包括自動檢測：

container: false

容器配置選項

• image：要使用的容器鏡像（必需）
• volumes：主機路徑到容器路徑的映射
• env：傳遞給容器的環境變量
• network：網絡模式（host, bridge 等）
• user：在容器中運行的用戶
• workdir：容器中的工作目錄
• args：傳遞給容器運行時的額外參數

自動容器檢測

姿勢(Posuer)能夠自動識別某些命令並將其在適當的容器中運行：

• npx 命令會自動在 docker.io/node:alpine 中運行。
• npm run 類型的命令會自動在 docker.io/node:alpine 中運行。

示例

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

這將啟動一個容器，運行 npx my-app。

與Claude Desktop集成

姿勢(Posuer)支持直接與Claude Desktop集成，方便用戶在桌面環境中管理MCP服務器。

示例配置

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

📄 許可證

姿勢(Posuer)遵循MIT許可證，具體條款請參見LICENSE文件。