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文件。