cib7-mcp

用于调查 CIB Seven 流程实例的 MCP 工具。为 Claude 提供全面的 CIB Seven REST API 知识，支持实时执行和 Keycloak 身份验证。

功能特性

7 个调查工具 — 流程实例、异常、活动历史记录、变量、BPMN XML、作业
语义化描述 — Claude 不仅能理解原始端点数据，还能理解每个字段的业务含义
BPMN 内省 — 获取流程定义 XML，Claude 可据此分析预期执行路径与实际执行路径
Keycloak 认证 — 支持 OIDC 客户端凭据流，并自动刷新令牌
变量脱敏 — 可配置的正则表达式模式，用于隐藏敏感数据
诊断提示词 — diagnose_stuck_process（诊断卡住的流程）和 incident_report（异常报告）工作流

安装

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "cib7": {
      "command": "npx",
      "args": ["cib7-mcp"],
      "env": {
        "CIB7_URL": "http://localhost:6009/rest"
      }
    }
  }
}

Claude Code

claude mcp add cib7-mcp -- npx cib7-mcp

然后将环境变量 CIB7_URL 设置为你的 CIB Seven 实例地址。

配置

所有配置均通过环境变量进行。

变量	必需	描述
`CIB7_URL`	是	CIB Seven REST API URL (例如 `http://localhost:6009/rest`)
`KEYCLOAK_URL`	否	Keycloak 服务器 URL (例如 `https://keycloak.example.com`)
`KEYCLOAK_REALM`	否	Keycloak 领域名称
`KEYCLOAK_CLIENT_ID`	否	Keycloak 客户端 ID
`KEYCLOAK_CLIENT_SECRET`	否	Keycloak 客户端密钥
`CIB7_REDACT_PATTERNS`	否	用于变量脱敏的逗号分隔正则表达式模式 (例如 `password.,secret.,token.*`)

如果设置了任何 KEYCLOAK_* 变量，则必须提供全部四个。如果均未设置，工具将以未认证模式运行。

使用 Keycloak

{
  "mcpServers": {
    "cib7": {
      "command": "npx",
      "args": ["cib7-mcp"],
      "env": {
        "CIB7_URL": "https://your-instance.com/rest",
        "KEYCLOAK_URL": "https://your-keycloak.com",
        "KEYCLOAK_REALM": "your-realm",
        "KEYCLOAK_CLIENT_ID": "mcp-client",
        "KEYCLOAK_CLIENT_SECRET": "your-secret",
        "CIB7_REDACT_PATTERNS": "password.*,secret.*,token.*,creditCard.*"
      }
    }
  }
}

工具

工具	描述
`get_process_instance`	通过 ID 查找流程实例 — 状态、定义、业务键
`list_process_instances`	按定义键、业务键或状态搜索流程实例
`list_incidents`	列出未解决的异常，可选择按流程实例过滤
`get_activity_history`	执行轨迹 — 按顺序记录运行的每一个活动
`get_process_variables`	流程实例的所有变量 (包含脱敏处理)
`get_process_definition_xml`	BPMN XML 模型 (已剔除图表元素以提高可读性)
`get_job_details`	作业执行详情 — 重试次数、异常消息

提示词

提示词	描述
`diagnose_stuck_process`	针对卡住的流程实例进行分步诊断
`incident_report`	包含根本原因分析的所有未解决异常的综合报告

使用示例

询问 Claude：

“流程 abc-123 是否卡住了？”
“显示所有未解决的异常”
“流程定义 orderProcess:1:456 的 BPMN 定义是什么？”
“生成一份异常报告”

开发

npm install
npm run build
npm test

需要 Node.js 18+。

许可证

MIT

Install Server

A

security – no known vulnerabilities

F

license - not found

A

quality - A tier

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

CIB Seven MCP Server