Posuer

🚀 姿势(Posuer)

姿势(Posuer)是一款用于管理多个MCP（Multiparty Compute Protocol）服务器的工具。它支持通过配置文件来定义和运行多个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

自动容器检测

姿势(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文件。