Boomi MCP服务器

用于Boomi平台API与Claude Code集成的安全MCP服务器

一个生产就绪的模型上下文协议（MCP）服务器，使Claude Code和其他MCP客户端能够使用OAuth 2.0身份验证和安全凭据存储与Boomi平台API进行交互。

🌐 现场服务: https://boomi.renera.ai

______________________________________________________________________

特性

🔐 谷歌OAuth 2.0 -使用同意屏幕进行安全身份验证
🔒 GCP秘密经理 -加密的每个用户凭据存储
👤 多配置文件支持 -每位用户最多可存储10个Boomi帐户配置文件
🌐 Web 用户界面 -基于浏览器的凭据管理
✅ 凭证验证 -保存前测试凭据
🚀 自动部署 -GitHub推送→ 云构建（固定KB版本）→ 云运行
📦 MCP工具 -29种工具，涵盖贸易伙伴、流程、组件、运行时、部署、计划、账户管理等
📚 Boomi Docs知识库 -可选检索增强 search_boomi_docs / read_boomi_doc_page 由固定知识库版本支持的工具
☁️ 云原生 -在Google Cloud Run上运行

______________________________________________________________________

快速开始

对于用户

访问Web UI: https://boomi.renera.ai

使用谷歌登录 -OAuth身份验证

添加Boomi凭据:

- 电子邮件：您的Boomi帐户电子邮件 - API代币：您的Boomi API代币 - 帐号ID：您的Boomi帐号ID - 配置文件名称：此凭据集的名称（例如，“生产”、“沙盒”）

连接克劳德代码:

claude mcp add --transport http boomi https://boomi.renera.ai/mcp

授权 -打开浏览器以获取OAuth同意，单击“批准”

使用MCP工具:

Show me my Boomi account information from the production profile

______________________________________________________________________

建筑

┌──────────────┐
│    User      │
│  (Browser)   │
└──────┬───────┘
       │ 1. Visit https://boomi.renera.ai
       │ 2. Google OAuth Login
       ▼
┌──────────────────────────────────────┐
│      Boomi MCP Server (Cloud Run)    │
│  ┌────────────┐    ┌──────────────┐ │
│  │  Web UI    │    │  MCP Server  │ │
│  │ (FastAPI)  │    │  (FastMCP)   │ │
│  └────────────┘    └──────────────┘ │
└───────┬──────────────────┬───────────┘
        │                  │
        │ Store            │ Retrieve
        │ Credentials      │ Credentials
        ▼                  ▼
┌──────────────────────────────────────┐
│      GCP Secret Manager              │
│  boomi-mcp-{user-id}-{profile-name}  │
└──────────────────────────────────────┘
                    │
                    │ API Calls
                    ▼
             ┌──────────────┐
             │  Boomi API   │
             └──────────────┘

______________________________________________________________________

可用的MCP工具

服务器公开了29个工具。所有工具都需要经过身份验证的会话和有效的 profile 指向存储的Boomi凭据集的参数。

账户和个人资料管理

list_boomi_profiles() --列出当前用户的已保存凭据配置文件。
boomi_account_info(profile) --获取指定配置文件的帐户详细信息。
set_boomi_credentials(...) / delete_boomi_profile(...) --凭证CRUD。
manage_account(...), manage_account_groups(...) --Boomi帐户管理员。

构建、部署和操作集成

manage_process, manage_component, analyze_component,

query_components, build_integration, get_schema_template

manage_environments, manage_runtimes, manage_deployment,

execute_process, troubleshoot_execution, manage_schedules, manage_listeners, manage_integration_packs

manage_trading_partner, manage_connector, manage_shared_resources,

manage_folders, monitor_platform

逃生舱口

invoke_boomi_api(...) --在没有专用工具的情况下调用任何Boomi REST端点

存在。

list_capabilities() --总结所有内容的可发现性助手

注册工具。

Boomi Docs知识库（可选）

仅在服务器启动时注册 BOOMI_DOCS_ENABLED=true 以及a 已填充KB BOOMI_DOCS_DB_PATH:

search_boomi_docs(query, ...) --跨索引的语义搜索

布米文献语料库。

read_boomi_doc_page(page_key) --获取特定商品的完整降价

文档页面。

资源 kb://boomi-docs/corpus --语料库清单（发布标签，页面

计数，在元数据处生成）。

KB语料库由以下人员构建和发布 RenEra-ai/knowledge-base-builder 并在构建时通过以下方式嵌入到图像中 deploy/kb-release.env。参见 KB发布促销在......下面

______________________________________________________________________

部署

当前生产部署

托管：谷歌云运行（以美元为中心1）
统一资源定位符: https://boomi.renera.ai
CI/CD：通过GitHub自动化
区域：美国中央1
认证：谷歌OAuth 2.0

CI/CD管道

推送时自动部署 main 分支：

GitHub Push → Cloud Build (cloudbuild.yaml) → Docker Build (KB pin) → Artifact Registry → Cloud Run

管道采用源头控制 cloudbuild.yaml 和将固定的Boomi Docs知识库版本嵌入到图像中。KB标签住在 deploy/kb-release.env 所以每个语料库版本更改是一个可见的仓库编辑——构建过程中不得使用浮动 latest KB发布。

KB发布促销

在 RenEra-ai/knowledge-base-builder，剪切手册 workflow_dispatch

释放（例如 kb-13).发布必须公布 boomi_knowledge_db.tar.gz 作为一种资产。

在这个repo中，插入单行 deploy/kb-release.env:

   KB_RELEASE_TAG=kb-13

打开带有该更改的PR并合并到 main.
Cloud Build触发器读取 cloudbuild.yaml，运行a curl -fI

对GitHub发布资产进行预检，然后使用以下命令构建映像 --build-arg KB_RELEASE_TAG=$KB_RELEASE_TAG.一个丢失或空的别针在任何Docker工作发生之前，构建失败。

Cloud Run已更新为 BOOMI_DOCS_ENABLED=true,

BOOMI_DOCS_DB_PATH=/app/kb/boomi_knowledge_db，以及 BOOMI_DOCS_RELEASE_TAG=，这将导致服务器注册 search_boomi_docs 和 read_boomi_doc_page 工具加上 kb://boomi-docs/corpus 启动时的资源。

云构建触发器迁移

现有触发器 8623a6fa-3295-430a-b018-7c728ba941e8 创建于未通过的内联自动生成配置 KB_RELEASE_TAG 并且做到了未设置KB运行时环境变量。将其指向受源代码控制的配置一次：

gcloud builds triggers update github 8623a6fa-3295-430a-b018-7c728ba941e8 \
  --project=boomimcp \
  --region=global \
  --build-config=cloudbuild.yaml

迁移后，每一次推动 main 运行步骤 cloudbuild.yaml 以及a git log -- cloudbuild.yaml deploy/kb-release.env 确切地显示了 KB版本已上线。

手动部署

如果你需要手动部署（跳过GitHub触发器）：

# Authenticate with GCP
gcloud auth login
gcloud config set project boomimcp

# Submit the same pipeline that the trigger runs.
# REPO_NAME and COMMIT_SHA are populated by Cloud Build only for
# trigger-driven runs, so pass them explicitly via --substitutions
# when submitting from the CLI.
gcloud builds submit \
  --config=cloudbuild.yaml \
  --substitutions="REPO_NAME=boomi-mcp-server,COMMIT_SHA=$(git rev-parse HEAD)"

# Or use the trigger by pushing
git push origin main

______________________________________________________________________

配置

环境变量（云运行）

OAuth代理持久化

MCP OAuth流需要云运行实例睡眠/重启才能存活。 OAuth状态通过Fernet加密存储在MongoDB Atlas中：

OIDC_CLIENT_ID          # Google OAuth client ID
OIDC_CLIENT_SECRET      # Google OAuth client secret
OIDC_BASE_URL           # https://boomi.renera.ai
SESSION_SECRET          # Session signing key for web UI
MONGODB_URI             # MongoDB Atlas connection string for OAuth state
JWT_SIGNING_KEY         # Stable key for signing MCP JWT tokens
STORAGE_ENCRYPTION_KEY  # Fernet key for encrypting OAuth tokens at rest

用户凭据存储

用户Boomi API证书单独存储在GCP密钥管理器中：

SECRETS_BACKEND         # gcp
GCP_PROJECT_ID          # boomimcp

格式： boomi-mcp-{user-id}-{profile-name}
例子： boomi-mcp-glebuar-at-gmail-com-production
加密：静止和运输中
访问：IAM控制，审计记录

Boomi Docs知识库

设置在云端运行 cloudbuild.yaml 在启动时注册知识库工具：

BOOMI_DOCS_ENABLED       # true to register KB tools and resource
BOOMI_DOCS_DB_PATH       # /app/kb/boomi_knowledge_db (in-image corpus path)
BOOMI_DOCS_RELEASE_TAG   # operational marker, mirrors deploy/kb-release.env

当 BOOMI_DOCS_ENABLED 如果KB模块未设置或为false，这 requirements-kb.txt 未加载依赖项，KB工具和 kb://boomi-docs/corpus 资源未注册。

______________________________________________________________________

本地开发

先决条件

Python 3.11+
谷歌云SDK
启用密钥管理器访问GCP项目

设置

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

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

# Install dependencies
pip install -r requirements.txt -r requirements-cloud.txt

# Configure environment
cp .env.example .env
# Edit .env with your OAuth credentials

在本地运行

# Set environment variables
export OIDC_CLIENT_ID="your-google-oauth-client-id"
export OIDC_CLIENT_SECRET="your-google-oauth-client-secret"
export OIDC_BASE_URL="http://localhost:8080"
export SESSION_SECRET="$(python3 -c 'import secrets; print(secrets.token_urlsafe(32))')"
export SECRETS_BACKEND=gcp
export GCP_PROJECT_ID=boomimcp

# Run server
python server_http.py

访问http://localhost:8080以访问web UI。

______________________________________________________________________

项目结构

boomi-mcp-server/
├── server.py                  # Core MCP server (FastMCP, all tool definitions)
├── server_http.py             # HTTP wrapper with OAuth middleware
├── src/boomi_mcp/
│   ├── auth.py                # Auth helpers
│   ├── cloud_auth.py          # OAuth provider implementations
│   ├── cloud_secrets.py       # Secret Manager backends (GCP/AWS/Azure)
│   ├── local_secrets.py       # Local filesystem secret backend
│   ├── credentials.py         # Credential storage models / validation
│   ├── sanitize.py            # Response sanitization helpers
│   ├── tools.py               # Shared tool helpers
│   ├── categories/            # Tool category groupings
│   ├── models/                # Pydantic models for SDK payloads
│   ├── utils/                 # Misc utilities
│   ├── xml_builders/          # Helpers that emit Boomi component XML
│   └── kb/                    # Boomi Docs knowledge-base (gated by BOOMI_DOCS_ENABLED)
│       ├── service.py         # Search + page retrieval over Chroma corpus
│       ├── manifest.py        # kb://boomi-docs/corpus resource
│       └── errors.py          # KB-specific exception types
├── templates/                 # Jinja2 web UI templates (credentials, login, ...)
├── static/                    # Web UI static assets
├── tests/                     # Unit + integration tests (incl. tests/kb)
├── docs/                      # Specs, plans, runbooks
├── agents/                    # Subagent configs (boomi-qa-tester, ...)
├── examples/                  # Usage examples
├── scripts/                   # Operational scripts
├── k8s/                       # Reference Kubernetes manifests
├── local_atom/                # Helpers for the local-atom dev profile
├── requirements.txt           # Core dependencies (FastMCP, ...)
├── requirements-cloud.txt     # Cloud provider SDKs
├── requirements-kb.txt        # KB dependencies (chromadb, sentence-transformers)
├── Dockerfile                 # Multi-stage Docker build (KB pin via ARG)
├── cloudbuild.yaml            # Cloud Build pipeline (pinned KB release)
├── deploy/
│   └── kb-release.env         # Pinned knowledge-base release tag
└── README.md                  # This file

______________________________________________________________________

安全功能

身份验证和授权

✅ 谷歌OAuth 2.0与PKCE
✅ OAuth同意屏幕（防止混淆的代理攻击）
✅ 基于会话的加密签名身份验证
✅ 每用户凭据隔离

数据保护

✅ 仅HTTPS（由Cloud Run强制执行）
✅ 静态加密凭据（GCP密钥管理器）
✅ 传输中加密的凭据（TLS）
✅ 环境变量中没有凭据
✅ 通过Cloud logging进行审核日志记录

访问控制

✅ 基于IAM的机密访问
✅ 配置文件限制（每位用户10个）
✅ 存储前的凭据验证
✅ 自动会话过期

______________________________________________________________________

监控和日志

查看日志

# Recent logs
gcloud run services logs read boomi-mcp-server \
  --region us-central1 --limit 50 --project boomimcp

# Follow logs in real-time
gcloud run services logs tail boomi-mcp-server \
  --region us-central1 --project boomimcp

# Check service status
gcloud run services describe boomi-mcp-server \
  --region us-central1 --project boomimcp

云控制台

服务: https://console.cloud.google.com/run/detail/us-central1/boomi-mcp-server
日志: https://console.cloud.google.com/run/detail/us-central1/boomi-mcp-server/logs
构建: https://console.cloud.google.com/cloud-build/builds?project=boomimcp

______________________________________________________________________

故障排除

无法连接到MCP服务器

检查服务是否正在运行：

curl https://boomi.renera.ai/

验证OAuth同意是否已完成：

- 浏览器应在以下期间打开 claude mcp add - 在同意屏幕上单击“批准” - 检查成功消息

检查克劳德代码MCP配置：

claude mcp list

凭据未保存

验证web UI中是否填写了所有字段
检查凭证验证通过情况
查看浏览器控制台是否有错误（F12）
检查服务器日志中的错误消息

API错误

验证Boomi凭据是否正确：

- 电子邮件应在Boomi中注册 - API令牌应有效 - 帐户ID应与您的帐户匹配

直接测试证书：

curl -u "BOOMI_TOKEN.email@example.com:your-token" \
  "https://api.boomi.com/api/rest/v1/YOUR_ACCOUNT_ID/Account/YOUR_ACCOUNT_ID"

______________________________________________________________________

贡献

欢迎投稿！拜托：

分叉存储库
创建要素分支(git checkout -b feature/amazing-feature)
提交您的更改(git commit -m 'Add amazing feature')
推到分支(git push origin feature/amazing-feature)
打开拉取请求

______________________________________________________________________

技术细节

FastMCP版本

目前固定到 FastMCP 3.1.1 在 requirements.txt。包括：

OAuth同意屏幕
会话中间件支持
谷歌OAuth提供商
服务器品牌（自定义图标、网站URL）

会话管理

用途 SessionMiddleware 来自Starlette
会话密钥存储在GCP密钥管理器中
会话通过加密签名的Cookie在请求之间持续存在
最大年龄：1小时（可配置）

配置文件管理

每位用户最多10个配置文件
需要配置文件名称（无默认配置文件）
每个用户的配置文件名称必须是唯一的
示例：“生产”、“沙盒”、“开发”、“暂存”

______________________________________________________________________

资源

现场服务: https://boomi.renera.ai
GitHub存储库: https://github.com/RenEra-ai/boomi-mcp-server
FastMCP文档: https://gofastmcp.com
Boomi Python SDK: https://github.com/RenEra-ai/boomi-python
MCP规范: https://modelcontextprotocol.io
Boomi平台API: https://help.boomi.com/docs/atomsphere/integration/platform_management/c-atm-platform_api_2cf25c18-ca93-43d2-a53e-048017d0b102/

______________________________________________________________________

许可证

MIT许可证-请参阅许可证文件以获取详细信息。

______________________________________________________________________

支持

对于问题、疑问或功能请求：

打开一个问题
包括相关日志（机密已编辑）
描述您的环境和复制步骤

______________________________________________________________________

致谢

建于 FastMCP 框架
整合 Boomi Python SDK
实施模型上下文协议
由谷歌云平台提供技术支持

______________________________________________________________________

最后更新: 2026-05-15 状态: ✅ 生产（稳定）版本：FastMCP 3.1.1

Boomi MCP Server

快速接入

详细介绍

Boomi MCP服务器

特性

快速开始

对于用户

建筑

可用的MCP工具

账户和个人资料管理

构建、部署和操作集成

逃生舱口

Boomi Docs知识库（可选）

部署

当前生产部署

CI/CD管道

KB发布促销

云构建触发器迁移

手动部署

配置

环境变量（云运行）

OAuth代理持久化

用户凭据存储

Boomi Docs知识库

本地开发

先决条件

设置

在本地运行

项目结构

安全功能

身份验证和授权

数据保护

访问控制

监控和日志

查看日志

云控制台

故障排除

无法连接到MCP服务器

凭据未保存

API错误

贡献

技术细节

FastMCP版本

会话管理

配置文件管理

资源

许可证

支持

致谢

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP