Boomi MCP

Boomi MCP 服务器

 ](https://github.com/glebuar/boomi-mcp-server/pkgs/container/boomi-mcp-server) 

这个仓库提供了一个简单的 模型上下文协议 用于与Boomi API交互的(MCP)服务器。该服务器使用（某种方式）将Boomi SDK操作作为MCP工具暴露出来 FastMCP。

目录

• 要求
• 快速入门
• 使用
• 从源代码运行
• Cursor/Claude 设置
• 运行测试
• 贡献；做出贡献

要求

• Python 3.10及以上版本
• Boomi API的访问凭据

快速入门

运行 Boomi MCP 服务器的推荐方式是使用 Docker：

# Pull the latest image
docker pull ghcr.io/glebuar/boomi-mcp-server:latest

# Run with environment variables
docker run -d --name boomi-mcp-server -p 8080:8080 \
  -e BOOMI_ACCOUNT=your_account \
  -e BOOMI_USER=your_user \
  -e BOOMI_SECRET=your_secret \
  ghcr.io/glebuar/boomi-mcp-server:latest

或者，您可以从源代码构建：

git clone https://github.com/glebuar/boomi-mcp-server.git
cd boomi-mcp-server
docker build -t boomi-mcp-server .
docker run -p 8080:8080 --env-file .env boomi-mcp-server

使用

使用环境变量或（其他方式）设置您的Boomi凭据 .env 文件 （复制提供的 .env.example 并填写您的值)：

BOOMI_ACCOUNT=...
BOOMI_USER=...
BOOMI_SECRET=...

如果一个 .env 如果工作目录中存在该文件，服务器将自动加载它。

使用Python客户端

在（此处）提供了一个Python客户端 src/boomi_mcp_client 程序化访问目录：

import sys
sys.path.append('src')
from boomi_mcp_client import MCPClient

client = MCPClient("http://localhost:8080")
print(client.list_tools())
result = client.call_tool("health_check")
print(result)

看 examples/using_client.py 为了一个完整的剧本 展示这些呼叫。

通过 Docker 运行

使用 Docker 是运行 Boomi MCP 服务器以供生产环境使用的推荐方式：

使用 Docker Compose（推荐）

1. 创建一个 .env 示例中的文件：

   cp .env.example .env
   # Edit .env with your Boomi credentials

1. 启动服务器：

   docker-compose up -d

1. 检查服务器是否正在运行：

   docker ps | grep boomi-mcp-server

直接使用Docker

# Build the image
docker build -t boomi-mcp-server .

# Run with environment variables
docker run -d \
  --name boomi-mcp-server \
  -p 8080:8080 \
  -e BOOMI_ACCOUNT=your_account \
  -e BOOMI_USER=your_user \
  -e BOOMI_SECRET=your_secret \
  boomi-mcp-server

# Or use an env file
docker run -d \
  --name boomi-mcp-server \
  -p 8080:8080 \
  --env-file .env \
  boomi-mcp-server

Docker 功能

• 非root用户以非特权用户身份运行，以确保安全
• 健康检查内置健康监测功能
• 优化后的层高效的缓存机制，实现更快的重建速度
• 已准备好投入生产包含所有必要的运行时依赖

从源代码运行

对于开发或者当你需要在本地运行服务器而无需使用Docker时：

先决条件

• Python 3.10+（或“Python 3.10及以上版本”）
• pip 或 uv 包管理器

设置

git clone https://github.com/glebuar/boomi-mcp-server.git
cd boomi-mcp-server

# Create virtual environment
python -m venv .venv
source .venv/bin/activate     # Linux/macOS
# or .venv\Scripts\activate    # Windows

# Install dependencies
pip install -r requirements.txt

运行服务器

# stdio mode (for Cursor/Claude Desktop integration)
python -m boomi_mcp_server.server

# SSE mode (HTTP server on port 8080)
python -m boomi_mcp_server.server --transport sse --port 8080

与Claude桌面版的集成

对于Claude Desktop集成，请将此添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "boomi": {
      "command": "python",
      "args": [
        "-m",
        "boomi_mcp_server.server"
      ],
      "cwd": "/path/to/boomi-mcp-server",
      "env": {
        "BOOMI_ACCOUNT": "your_account",
        "BOOMI_USER": "your_user",
        "BOOMI_SECRET": "your_secret"
      }
    }
  }
}

特点/特性

该服务器提供了85多种工具，涵盖了Boomi集成的完整生命周期：

核心工作流程支持

• 发现查询组件、环境、原子（或元素）和文件夹
• 发展创建/更新组件，管理文件夹
• 包装创建带版本的软件包以进行部署
• 部署部署包，检查部署状态
• 执行运行带参数的进程，管理附件
• 监测查询执行、查看日志、跟踪性能
• 调试访问详细的日志、工件和错误记录
• 管理处理日程、属性、扩展

连接器支持

• AS2、EDI（X12/EDIFACT）、HL7、OFTP2、RosettaNet、Tradacoms
• 查询连接器记录并检索工件
• 管理连接器配置

高级功能

• 用于执行的进程-原子附件
• 环境-原子附件
• 队列管理与监听器控制
• 审计日志和系统事件
• 文档重运行功能
• 运行时重启管理

见 docs/cursor_setup.md 翻译为中文是：“文档/光标设置.md” 或者更自然地表达为：“文档中的光标设置指南.md”（具体翻译可能根据上下文有所调整，这里提供了较为通用的翻译） 关于设置的说明 使用 Cursor/Claude Desktop 客户端连接到服务器。

发展

运行测试

要运行测试，您需要安装开发依赖项：

# Clone the repository
git clone https://github.com/glebuar/boomi-mcp-server.git
cd boomi-mcp-server

# Create virtual environment
python -m venv .venv
source .venv/bin/activate

# Install test dependencies
pip install -r requirements.txt
pip install pytest pytest-cov ruff

# Run tests
pytest

# Run linter
ruff check .

贡献

如果您遇到问题或有任何建议，请提出问题或提交拉取请求 改进。确保 pytest 和 ruff 在提交更改前进行审核。