cib7-mcp

CIB Seven 프로세스 인스턴스를 조사하기 위한 MCP 도구입니다. Claude에게 실시간 실행 및 Keycloak 인증을 포함한 CIB Seven REST API에 대한 포괄적인 지식을 제공합니다.

기능

• 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 인스턴스로 설정하세요.

구성

모든 구성은 환경 변수를 통해 이루어집니다.

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.*"
      }
    }
  }
}

도구

프롬프트

사용 예시

Claude에게 다음과 같이 질문하세요:

• "프로세스 abc-123이 멈췄나요?"

• "열려 있는 모든 인시던트를 보여줘"

• "프로세스 정의 orderProcess:1:456의 BPMN 정의는 무엇인가요?"

• "인시던트 보고서를 생성해줘"

개발

npm install
npm run build
npm test

Node.js 18+ 버전이 필요합니다.

라이선스

MIT