open-index/open-npm huggingface dataset:
npm package: @g1cloud/bluework4-tool
Description: Bluework4 MCP Server - TypeScript version
Latest version: 1.0.0

# 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 목록 조회 |

## 설치

```bash
npm install
npm run build
```

## 환경 변수

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

## 실행

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

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

## MCP 클라이언트 설정

### Claude Desktop

`claude_desktop_config.json`:

```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`:

```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