Bluework4 MCP Tool (TypeScript)

Bluework4 API와 연동하는 MCP(Model Context Protocol) 서버입니다.

기능

Bluework4에서 UI 모델 및 Entity 모델 정보를 조회하는 6개의 Tool을 제공합니다.

| Tool | 설명 | |------|------| | getUiModel | UI 모델 정보 조회 | | getEntityModel | Entity 모델 조회 | | getEntityModelText | 비즈니스 모듈별 Entity 텍스트 조회 | | getUiList | UI 화면 목록 조회 (페이징) | | getBizModuleList | 비즈니스 모듈 목록 조회 (페이징) | | getBizModuleEntities | 모듈별 Entity 목록 조회 |

설치

npm install
npm run build

환경 변수

| 변수 | 설명 | 필수 | |------|------|------| | BLUEWORK4_BASE_URL | Bluework4 API 서버 URL | Yes | | BLUEWORK4_API_KEY | API 인증 키 | Yes | | BLUEWORK4_PROJECT_ID | 프로젝트 ID | Yes |

실행

# 빌드 후 실행
node dist/index.js

# 개발 모드 (tsx 사용)
npm run dev

MCP 클라이언트 설정

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "bluework4-tool": {
      "command": "node",
      "args": ["/path/to/bluework4-tool-ts/dist/index.js"],
      "env": {
        "BLUEWORK4_BASE_URL": "https://your-bluework4-server.com",
        "BLUEWORK4_API_KEY": "your-api-key",
        "BLUEWORK4_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Claude Code

.claude/settings.local.json 또는 ~/.claude/settings.json:

{
  "mcpServers": {
    "bluework4-tool": {
      "command": "node",
      "args": ["/path/to/bluework4-tool-ts/dist/index.js"],
      "env": {
        "BLUEWORK4_BASE_URL": "https://your-bluework4-server.com",
        "BLUEWORK4_API_KEY": "your-api-key",
        "BLUEWORK4_PROJECT_ID": "your-project-id"
      }
    }
  }
}

기술 스택

• Node.js 20+
• TypeScript
• MCP SDK (@modelcontextprotocol/sdk)
• tsup (빌드)

라이선스

MIT