使用姿势(Posuer)

介绍

姿势(posuer)是一个用于管理多个MCP（Multiparty Compute Protocol）服务器的工具。它支持通过配置文件定义和运行多个MCP服务器实例，并提供了容器化支持和自动检测功能，简化了开发和部署流程。

以下是姿势(posuer)的主要特性：

• 支持多种MCP服务器类型：包括基于标准输入输出(stdio)和基于流式扩展(sse)的服务器。
• 容器配置：可以为每个服务器指定容器运行时参数，实现更好的隔离和依赖管理。
• 自动检测：能够自动识别常见的命令并启动相应的容器环境。
• 配置热重载：支持在不重启姿势(posuer)的情况下更新配置文件。

服务器配置

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)的开发流程如下：

1. 安装依赖：

   npm install
   

2. 构建项目：

   npm run build
   

3. 运行测试：

   npm test
   

许可证

姿势(posuer)遵循MIT许可证，具体条款请参见LICENSE文件。