cib7-mcp

MCP-инструмент для исследования экземпляров процессов CIB Seven. Предоставляет Claude исчерпывающие знания о REST API CIB Seven с возможностью выполнения в реальном времени и аутентификацией 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`	Да	URL REST API CIB Seven (например, `http://localhost:6009/rest`)
`KEYCLOAK_URL`	Нет	URL сервера Keycloak (например, `https://keycloak.example.com`)
`KEYCLOAK_REALM`	Нет	Имя области (realm) Keycloak
`KEYCLOAK_CLIENT_ID`	Нет	ID клиента Keycloak
`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:

"Is process abc-123 stuck?"
"Show me all open incidents"
"What's the BPMN definition for process definition orderProcess:1:456?"
"Generate an incident report"

Разработка

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