@g1cloud/bluework4-tool 1.0.0

package/README.md

@@ -0,0 +1,94 @@
+# 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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,307 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+// src/config.ts
+function loadConfig() {
+  const baseUrl = process.env.BLUEWORK4_BASE_URL;
+  const apiKey = process.env.BLUEWORK4_API_KEY;
+  const projectId = process.env.BLUEWORK4_PROJECT_ID;
+  if (!baseUrl) {
+    throw new Error("BLUEWORK4_BASE_URL environment variable is required");
+  }
+  if (!apiKey) {
+    throw new Error("BLUEWORK4_API_KEY environment variable is required");
+  }
+  if (!projectId) {
+    throw new Error("BLUEWORK4_PROJECT_ID environment variable is required");
+  }
+  return { baseUrl, apiKey, projectId };
+}
+
+// src/client.ts
+var Bluework4Client = class {
+  baseUrl;
+  apiKey;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+  }
+  async get(path, params) {
+    const url = new URL(path, this.baseUrl);
+    if (params) {
+      Object.entries(params).forEach(([key, value]) => {
+        if (value !== void 0 && value !== null && value !== "") {
+          url.searchParams.set(key, String(value));
+        }
+      });
+    }
+    const response = await fetch(url.toString(), {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        Accept: "application/json, text/plain, */*"
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+    return response.text();
+  }
+};
+
+// src/tools/getUiModel.ts
+import { z } from "zod";
+var getUiModelSchema = z.object({
+  uiId: z.string().describe("The UI ID to retrieve")
+});
+async function getUiModel(args, client, config) {
+  try {
+    const path = `/tool/openapi/${config.projectId}/uiModel/${args.uiId}/text`;
+    return await client.get(path);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return `Error fetching UI model: ${message}`;
+  }
+}
+var getUiModelTool = {
+  name: "getUiModel",
+  description: "Get UI model information from Bluework4. Returns the UI screen definition in text format.",
+  schema: getUiModelSchema,
+  handler: getUiModel
+};
+
+// src/tools/getEntityModel.ts
+import { z as z2 } from "zod";
+var getEntityModelSchema = z2.object({
+  entityName: z2.string().optional().describe(
+    "The entity name to retrieve. Optional - if not provided, returns all entities."
+  )
+});
+async function getEntityModel(args, client, config) {
+  try {
+    const path = `/tool/openapi/${config.projectId}/entityModel`;
+    const params = {};
+    if (args.entityName) {
+      params.entity = args.entityName;
+    }
+    return await client.get(path, params);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return `Error fetching Entity model: ${message}`;
+  }
+}
+var getEntityModelTool = {
+  name: "getEntityModel",
+  description: "Get Entity model information from Bluework4. Returns entity definitions. If entityName is not provided, returns all entities.",
+  schema: getEntityModelSchema,
+  handler: getEntityModel
+};
+
+// src/tools/getEntityModelText.ts
+import { z as z3 } from "zod";
+var getEntityModelTextSchema = z3.object({
+  id: z3.string().describe("The business module ID or moduleId"),
+  entity: z3.string().optional().describe("Entity name filter (comma-separated)"),
+  table: z3.string().optional().describe("Table name filter (comma-separated)"),
+  packageName: z3.string().optional().describe("Package name filter (comma-separated)")
+});
+async function getEntityModelText(args, client, config) {
+  try {
+    const path = `/tool/openapi/${config.projectId}/entityModel/${args.id}/text`;
+    const params = {
+      entity: args.entity,
+      table: args.table,
+      package: args.packageName
+    };
+    return await client.get(path, params);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return `Error fetching Entity model text: ${message}`;
+  }
+}
+var getEntityModelTextTool = {
+  name: "getEntityModelText",
+  description: "Get Entity model text from Bluework4. Returns entity definitions from a specific business module.",
+  schema: getEntityModelTextSchema,
+  handler: getEntityModelText
+};
+
+// src/tools/getUiList.ts
+import { z as z4 } from "zod";
+var getUiListSchema = z4.object({
+  uiId: z4.string().optional().describe("UI ID filter"),
+  uiName: z4.string().optional().describe("UI name filter"),
+  uiType: z4.string().optional().describe("UI type filter"),
+  menu1: z4.string().optional().describe("Menu level 1 filter"),
+  menu2: z4.string().optional().describe("Menu level 2 filter"),
+  sort: z4.string().optional().describe("Sort (e.g., 'uiId', '-updateDate')"),
+  offset: z4.number().optional().describe("Offset (default: 0)"),
+  limit: z4.number().optional().describe("Limit (default: 100)")
+});
+async function getUiList(args, client, config) {
+  try {
+    const path = `/tool/openapi/${config.projectId}/ui`;
+    const params = {
+      uiId: args.uiId,
+      uiName: args.uiName,
+      uiType: args.uiType,
+      menu1: args.menu1,
+      menu2: args.menu2,
+      sort: args.sort,
+      offset: args.offset,
+      limit: args.limit
+    };
+    return await client.get(path, params);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return `Error fetching UI list: ${message}`;
+  }
+}
+var getUiListTool = {
+  name: "getUiList",
+  description: "Get UI screen list from Bluework4. Returns paginated list of UI screens.",
+  schema: getUiListSchema,
+  handler: getUiList
+};
+
+// src/tools/getBizModuleList.ts
+import { z as z5 } from "zod";
+var getBizModuleListSchema = z5.object({
+  moduleId: z5.string().optional().describe("Module ID filter"),
+  moduleName: z5.string().optional().describe("Module name filter"),
+  sort: z5.string().optional().describe("Sort (e.g., 'moduleId', '-updateDate')"),
+  offset: z5.number().optional().describe("Offset (default: 0)"),
+  limit: z5.number().optional().describe("Limit (default: 100)")
+});
+async function getBizModuleList(args, client, config) {
+  try {
+    const path = `/tool/openapi/${config.projectId}/bizModule`;
+    const params = {
+      moduleId: args.moduleId,
+      moduleName: args.moduleName,
+      sort: args.sort,
+      offset: args.offset,
+      limit: args.limit
+    };
+    return await client.get(path, params);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return `Error fetching business module list: ${message}`;
+  }
+}
+var getBizModuleListTool = {
+  name: "getBizModuleList",
+  description: "Get business module list from Bluework4. Returns paginated list.",
+  schema: getBizModuleListSchema,
+  handler: getBizModuleList
+};
+
+// src/tools/getBizModuleEntities.ts
+import { z as z6 } from "zod";
+var getBizModuleEntitiesSchema = z6.object({
+  id: z6.string().describe("Business module ID or moduleId"),
+  entityName: z6.string().optional().describe("Entity name filter"),
+  logicalName: z6.string().optional().describe("Logical name filter"),
+  physicalName: z6.string().optional().describe("Physical name filter")
+});
+async function getBizModuleEntities(args, client, config) {
+  try {
+    const path = `/tool/openapi/${config.projectId}/bizModule/${args.id}/entities`;
+    const params = {
+      entityName: args.entityName,
+      logicalName: args.logicalName,
+      physicalName: args.physicalName
+    };
+    return await client.get(path, params);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return `Error fetching business module entities: ${message}`;
+  }
+}
+var getBizModuleEntitiesTool = {
+  name: "getBizModuleEntities",
+  description: "Get entity list for a specific business module from Bluework4.",
+  schema: getBizModuleEntitiesSchema,
+  handler: getBizModuleEntities
+};
+
+// src/tools/index.ts
+function registerTools(server, client, config) {
+  server.tool(
+    getUiModelTool.name,
+    getUiModelTool.description,
+    getUiModelSchema.shape,
+    async (args) => {
+      const result = await getUiModel(args, client, config);
+      return { content: [{ type: "text", text: result }] };
+    }
+  );
+  server.tool(
+    getEntityModelTool.name,
+    getEntityModelTool.description,
+    getEntityModelSchema.shape,
+    async (args) => {
+      const result = await getEntityModel(args, client, config);
+      return { content: [{ type: "text", text: result }] };
+    }
+  );
+  server.tool(
+    getEntityModelTextTool.name,
+    getEntityModelTextTool.description,
+    getEntityModelTextSchema.shape,
+    async (args) => {
+      const result = await getEntityModelText(args, client, config);
+      return { content: [{ type: "text", text: result }] };
+    }
+  );
+  server.tool(
+    getUiListTool.name,
+    getUiListTool.description,
+    getUiListSchema.shape,
+    async (args) => {
+      const result = await getUiList(args, client, config);
+      return { content: [{ type: "text", text: result }] };
+    }
+  );
+  server.tool(
+    getBizModuleListTool.name,
+    getBizModuleListTool.description,
+    getBizModuleListSchema.shape,
+    async (args) => {
+      const result = await getBizModuleList(args, client, config);
+      return { content: [{ type: "text", text: result }] };
+    }
+  );
+  server.tool(
+    getBizModuleEntitiesTool.name,
+    getBizModuleEntitiesTool.description,
+    getBizModuleEntitiesSchema.shape,
+    async (args) => {
+      const result = await getBizModuleEntities(args, client, config);
+      return { content: [{ type: "text", text: result }] };
+    }
+  );
+}
+
+// src/index.ts
+var SERVER_NAME = "bluework4-mcp-server";
+var SERVER_VERSION = "0.0.1";
+async function main() {
+  const config = loadConfig();
+  const client = new Bluework4Client(config);
+  const server = new McpServer({
+    name: SERVER_NAME,
+    version: SERVER_VERSION
+  });
+  registerTools(server, client, config);
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error(`${SERVER_NAME} v${SERVER_VERSION} started`);
+}
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@g1cloud/bluework4-tool",
+  "private": false,
+  "version": "1.0.0",
+  "description": "Bluework4 MCP Server - TypeScript version",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "bluework4-tool": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "bluework4",
+    "ai"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  }
+}