DATMT MCP Tool Pods
?좏븳?쇱씠???낅Т 湲곕뒫??MCP(Model Context Protocol) Tool濡??쒓났?섎뒗 Java 硫??紐⑤뱢 ?꾨줈?앺듃?낅땲?? 媛??낅Т 紐⑤뱢? ?낅┰ ?ㅽ뻾 媛?ν븳 Spring Boot ?좏뵆由ъ??댁뀡?대ʼn, MCP Streamable HTTP? REST ?ㅽ뻾 API瑜??④퍡 ?쒓났?⑸땲??
????μ냼?먮뒗 DATMS(Gateway) ?좏뵆由ъ??댁뀡???ы븿?섏뼱 ?덉? ?딆뒿?덈떎. DATMT??Gateway濡?Tool??push ?깅줉?섏? ?딆쑝硫? 媛?Pod媛 GET /tool-manifest瑜??쒓났?섎㈃ DATMS媛 ??Manifest瑜?pull?섏뿬 Tool 紐⑸줉??援ъ꽦?⑸땲?? Tool 議고쉶? 吏곸젒 ?ㅽ뻾? 媛?Pod?먯꽌???먯껜?곸쑝濡?泥섎━?⑸땲??
湲곗닠 湲곗?
- Java 21
- Gradle Wrapper 8.14.3
- Spring Boot 3.5.11
- MCP Java SDK 2.0.0
- Spring AI Community MCP Annotations 0.9.0
- Jackson 2.19.4 (Spring Boot BOM)
- MapStruct, MyBatis, Redis, Kafka, Resilience4j
- JUnit 5
紐⑤뱢 援ъ꽦
| 紐⑤뱢 | ??븷 | 湲곕낯 ?ы듃 | Tool ?? |
|---|---|---|---|
dat-was-lib |
MCP ?쒕쾭, Tool ?ㅼ틪쨌?ㅽ뻾, Schema, Manifest, 蹂댁븞, MCI/EAI/HTTP ?곕룞 怨듯넻 湲곕뒫 | - | - |
dat-was-cus |
怨좉컼쨌CRM쨌VOC쨌??肄섑뀗痢?愿由?Tool | 8084 | 51 |
dat-was-sal |
?곸뾽쨌泥?뎄쨌?몄닔쨌?숈쓽쨌?꾩옣吏??Tool | 8082 | 52 |
dat-was-pro |
?곹뭹 ?곸뿭 Tool(媛쒖씤怨좉컼 ?곸꽭議고쉶쨌紐⑥쭛?섏닔猷?怨듭떆) | 8085 | 2 |
dat-was-sys |
IAM쨌?쒖뒪???곹깭쨌怨듭?쨌?먭?쨌諛고룷 Tool | 8086 | 51 |
?낅Т 紐⑤뱢?먮뒗 珥?156媛쒖쓽 @McpTool ?좎뼵???덉뒿?덈떎. ?꾩옱 ?낅Т 紐⑤뱢??src/main/resources?먮뒗 蹂꾨룄 tool-definitions YAML???놁쑝硫? Tool 硫뷀??곗씠?곕뒗 ?대끂?뚯씠?섍낵 @GrowToolHint瑜?湲곗??쇰줈 ?앹꽦?⑸땲??
?꾩옱 ?낅Т 援ы쁽? 媛쒕컻쨌?곕룞 寃利??④퀎?낅땲?? dat-was-sal??cmm_claim_search? cmm_memo_retriever??媛곴컖 MCI? HTTP Client ?먮쫫???ъ슜?섎ʼn, ?섎㉧吏 Tool? ?몃? ?쒖뒪?쒖쓣 蹂寃쏀븯吏 ?딅뒗 紐⑥쓽 ?묐떟??以묒떖?쇰줈 援ы쁽?섏뼱 ?덉뒿?덈떎.
泥섎━ 援ъ“
MCP Client ?먮뒗 REST Client
?쒋? MCP Streamable HTTP: /mcp
?붴? REST: POST /mcp/{toolName}
??
??
Tool Pod
?쒋? McpToolMethodRegistry
?? ?붴? Spring Bean??@McpTool 硫붿꽌???먯깋 諛??ㅽ뻾 硫붿꽌??罹먯떆
?쒋? ToolRegistryHeartbeatSender
?? ?쒋? Tool 硫뷀??곗씠???앹꽦
?? ?붴? tool-definitions YAML 蹂묓빀
?쒋? ToolManifestService
?? ?붴? DATMS媛 pull??bundle ?⑥쐞 Manifest ?앹꽦
?쒋? McpToolExecutionService
?? ?쒋? ?낅젰 Schema 寃利?
?? ?쒋? ?붿껌 DTO 蹂??諛?Tool ?몄텧
?? ?붴? 異쒕젰 Schema 寃利?
?붴? UseCase ??Converter ??MCI/EAI/HTTP Client ?먮뒗 Mock ?묐떟
?좏뵆由ъ??댁뀡 ?쒖옉 ???ㅼ쓬 ?쒖꽌濡?Tool??以鍮꾨맗?덈떎.
ToolDefinitionRepository??classpath*:tool-definitions/**/*.yml寃쎈줈???뺤쓽媛 ?덉쓣 寃쎌슦 ?대? ?쎄퀬 V17 ?꾩닔 ??ぉ??寃利앺빀?덈떎.ToolRegistryHeartbeatSender媛@McpTool硫붿꽌?쒕? ?ㅼ틪?섍퀬, 議댁옱?섎뒗 YAML ?뺤쓽媛 ?덉쑝硫?蹂묓빀??ToolMetadata瑜??앹꽦?⑸땲??McpToolMethodRegistry媛 ?ㅼ젣 ?몄텧 媛?ν븳 Bean怨?硫붿꽌?쒕? Tool ?대쫫?쇰줈 罹먯떆?⑸땲??ToolPodMcpToolSynchronizer媛 Tool??MCP SDK ?쒕쾭???깅줉?⑸땲??- REST? MCP ?붿껌? 怨듯넻
McpToolExecutionService瑜??듯빐 ?ㅽ뻾?⑸땲??
DATMT ?대??먮뒗 /registry/register, /registry/deregister ?몄텧?대굹 二쇨린?곸씤 Gateway heartbeat ?꾩넚???놁뒿?덈떎. ToolRegistryHeartbeatSender?쇰뒗 ?대옒?ㅻ챸? ?명솚?깆쓣 ?꾪빐 ?⑥븘 ?덉?留??꾩옱 ??븷? 濡쒖뺄 Tool ?ㅼ틪怨?硫뷀??곗씠???앹꽦肉먯엯?덈떎.
DATMS ?곕룞 諛⑹떇
DATMS
?붴? GET {DATMT Pod URL}/tool-manifest
?붴? bundleId + revision + tools[]
?붴? 媛?Tool endpoint: {Pod URL}/mcp/{toolName}
mcp.manifest.bundle-id??Manifest瑜??쒓났?섎뒗 Pod??怨좎쑀 ?앸퀎?먯씠硫??꾩닔?낅땲??- ?꾩옱 媛믪?
was-sal,was-cus,was-pro,was-sys?낅땲?? - DATMS???ㅼ젙??bundle ID? DATMT媛 諛섑솚?섎뒗
bundleId媛 ?쇱튂?댁빞 媛숈? Tool bundle濡?愿由щ맗?덈떎. mcp.manifest.name-prefix媛 鍮꾩뼱 ?덉? ?딆쑝硫?紐⑤뱺 Tool ?대쫫???대떦 prefix濡??쒖옉?댁빞 ?⑸땲??- Manifest ?댁슜??諛붾뚮㈃
revision??利앷??섎ʼn,If-None-Match媛 ?쇱튂?섎㈃304 Not Modified瑜?諛섑솚?⑸땲??
?쒓났 API
媛??낅Т Pod媛 ?숈씪??API 援ъ“瑜??쒓났?⑸땲??
| 紐⑹쟻 | 硫붿꽌?? | 寃쎈줈 |
|---|---|---|
| MCP Streamable HTTP | MCP ?꾨줈?좎퐳 | /mcp |
| MCP 硫붿떆吏 ?꾩넚 | MCP ?꾨줈?좎퐳 | /mcp/message |
| 濡쒖뺄 Tool 硫뷀??곗씠??議고쉶 | GET |
/mcp/api/v1/tools/local |
| Tool 吏곸젒 ?ㅽ뻾 | POST |
/mcp/{toolName} |
| Tool Manifest 議고쉶 | GET |
/tool-manifest |
| 移댄뀒怨좊━蹂?Tool Manifest 議고쉶 | GET |
/tool-manifest/{categoryKey} |
GET /tool-manifest??If-None-Match ?붿껌 ?ㅻ뜑瑜?吏?먰빀?덈떎. Manifest媛 蹂寃쎈릺吏 ?딆븯?쇰㈃ 304 Not Modified瑜?諛섑솚?⑸땲??
REST ?ㅽ뻾 ?덉떆
?ㅼ쓬? SYS Pod???쒖뒪???곹깭 Tool ?몄텧 ?덉떆?낅땲??
$headers = @{
'X-Tool-Server-API-Key' = $env:TOOL_SERVER_API_KEY
'X-Guid' = 'guid-local-001'
'X-Praf-No' = '100001'
'X-Request-Id' = 'request-local-001'
'X-Request-Time' = '2026-08-25T12:34:56+09:00'
'X-Vrtl-Praf-No' = 'V100001'
'X-App-Code' = 'DATMT'
'X-Project-Code' = 'AXHUB'
'X-User-Ip' = '10.0.0.10'
'X-Caller-Ip' = '10.0.0.20'
'X-Caller-Host' = 'caller.example.internal'
'X-Channel' = 'MCP'
'X-Agent-Id' = 'agent-local-001'
'mcp-session-id' = 'session-local-001'
}
Invoke-RestMethod `
-Method Post `
-Uri 'http://localhost:8086/mcp/iam_system_status' `
-Headers $headers `
-ContentType 'application/json' `
-Body '{"environment":"媛쒕컻"}'
?붿껌 ?ㅻ뜑 怨꾩빟
DATMS媛 DATMT Tool Service瑜??몄텧?????ъ슜?섎뒗 ?ㅻ뜑???ㅼ쓬怨?媛숈뒿?덈떎. HTTP ?ㅻ뜑 ?대쫫? ??뚮Ц?먮? 援щ텇?섏? ?딆?留? 臾몄꽌? 援ы쁽?먯꽌???꾨옒 ?쒓린瑜?湲곗??쇰줈 ?ъ슜?⑸땲??
| ?ㅻ뜑 | ?꾩닔 ?щ? | ?⑸룄 | ?꾨떖 ?숈옉 |
|---|---|---|---|
X-Tool-Server-API-Key |
?몄쬆 ?ㅼ젙 ???꾩닔 | DATMS? DATMT ?ъ씠??Tool Server ?몄쬆 | mcp.security.api-key ?먮뒗 api-keys? 鍮꾧탳 |
X-Guid |
?좏깮 | ?낅Т ?몄텧 ?곴?愿怨??앸퀎?? | ?ㅽ뻾 濡쒓렇, ?깃났 ?묐떟, ?섏쐞 HTTP ?몄텧濡??꾨떖 |
X-Praf-No |
?좏깮 | ?ㅼ젣 ?ъ슜???щ쾲 | ?몄뀡 議고쉶? ?섏쐞 HTTP ?몄텧濡??꾨떖 |
X-Request-Id |
?좏깮 | ?붿껌 異붿쟻 ?앸퀎?? | ?ㅽ뻾 濡쒓렇, ?깃났 ?묐떟, ?섏쐞 HTTP ?몄텧濡??꾨떖 |
X-Request-Time |
?좏깮 | ?붿껌 諛쒖깮 ?쒓컖 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
X-Vrtl-Praf-No |
?좏깮 | 媛???ъ슜???щ쾲 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
X-App-Code |
?좏깮 | ?몄텧 ?좏뵆由ъ??댁뀡 肄붾뱶 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
X-Project-Code |
?좏깮 | ?몄텧 ?꾨줈?앺듃 肄붾뱶 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
X-User-Ip |
?좏깮 | ?ъ슜??IP 二쇱냼 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
X-Caller-Ip |
?좏깮 | ?몄텧 ?쒖뒪??IP 二쇱냼 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
X-Caller-Host |
?좏깮 | ?몄텧 ?쒖뒪???몄뒪?몃챸 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
X-Channel |
?좏깮 | ?몄텧 梨꾨꼸 | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
X-Agent-Id |
?좏깮 | ?몄텧 Agent ?앸퀎?? | ?섏쐞 HTTP ?몄텧濡??꾨떖 |
mcp-session-id |
?좏깮 | MCP ?몄뀡 ?앸퀎?? | ?깃났 ?묐떟怨??섏쐞 HTTP ?몄텧濡??꾨떖 |
McpRequestHeaderFilter??URI??/mcp媛 ?ы븿???붿껌?먯꽌 ???ㅻ뜑瑜?McpRequestHeaderContext????ν븯誘濡?REST /mcp/{toolName}怨?MCP Streamable HTTP /mcp, /mcp/message??紐⑤몢 ?곸슜?⑸땲?? REST 寃쎈줈??BusinessToolController???숈씪???ㅻ뜑瑜?吏곸젒 ?쎌뼱 ?ㅽ뻾 ?쒕퉬?ㅼ뿉 ?꾨떖?⑸땲?? ?ㅻ뜑媛 ?녿뒗 ?섏쐞 HTTP ?몄텧?먮뒗 X-ANONYMOUS-REQ: AXHUB-TOOL???ㅼ젙?⑸땲??
湲곗〈 guid, employee-no, virtual-employee-no ?ㅻ뜑??吏?먰븯吏 ?딆뒿?덈떎.
二쇱슂 ?ㅽ뻾 ?묐떟? ?ㅼ쓬怨?媛숈뒿?덈떎.
| HTTP ?곹깭 | 肄붾뱶 | ?섎? |
|---|---|---|
| 200 | - | Tool ?ㅽ뻾 ?깃났 |
| 404 | TOOL_NOT_FOUND |
?붿껌??Tool ?대쫫???놁쓬 |
| 422 | INVALID_PARAM |
?붿껌???낅젰 Schema? ?쇱튂?섏? ?딆쓬 |
| 500 | INVALID_TOOL_RESPONSE |
寃곌낵媛 異쒕젰 Schema? ?쇱튂?섏? ?딆쓬 |
| 502 | TOOL_ERROR |
Tool ?ㅽ뻾 以??덉쇅 諛쒖깮 |
Tool 援ы쁽 諛⑹떇
?몄텧 媛?ν븳 硫붿꽌?쒕뒗 Spring AI Community??@McpTool濡??좎뼵?⑸땲?? ?꾨줈?앺듃 怨좎쑀 ?ㅽ뻾쨌?쒖떆 ?뺣낫??@GrowToolHint濡?蹂댁셿?⑸땲??
@McpTool(
name = "iam_system_status",
title = "?쒖뒪???곹깭 議고쉶",
description = "紐⑥쓽 ?쒖뒪???곹깭 ?뺣낫瑜?議고쉶?⑸땲??",
annotations = @McpTool.McpAnnotations(openWorldHint = false)
)
@GrowToolHint(
categoryKey = "iam",
mappingId = "DIRECT_IAM_STATUS",
requiresApproval = false
)
SystemStatusResponse getSystemStatus(SystemStatusRequest request);
@McpTool.name? ?ㅼ쓬 ?뺤떇???ъ슜?⑸땲??
^[a-z][a-z0-9_]{2,63}$
?? cmm_claim_search, crm_customer_detail, iam_system_status
?대쫫 以묐났怨??뺤떇? validateMcpToolNames Gradle ?묒뾽?쇰줈 寃?ы빀?덈떎. ?꾩옱 猷⑦듃 build.gradle?먮뒗 validateToolSchemaV17 Gradle ?묒뾽???깅줉?섏뼱 ?덉? ?딆쑝硫? 紐⑤뱺 bootJar ?묒뾽? validateMcpToolNames?먮쭔 ?섏〈?⑸땲??
Tool YAML ?뺤쓽
怨듯넻 ?쇱씠釉뚮윭由щ뒗 Tool 硫뷀??곗씠?곕? 蹂닿컯?섍린 ?꾪븳 ?좏깮??YAML ?뺤쓽瑜?吏?먰빀?덈떎. YAML ?뺤쓽瑜?異붽???寃쎌슦 ?낅Т 紐⑤뱢???ㅼ쓬 寃쎈줈瑜??ъ슜?⑸땲??
dat-was-*/src/main/resources/tool-definitions/{category}/{tool-name}.yml
?꾩옱 ?낅Т 紐⑤뱢?먮뒗 ??寃쎈줈??YAML ?뺤쓽媛 ?놁뒿?덈떎. ?곕씪???ㅽ뻾 ??硫뷀??곗씠?곕뒗 @McpTool, @GrowToolHint, DTO Schema瑜?湲곗??쇰줈 援ъ꽦?⑸땲?? YAML ?뺤쓽瑜??꾩엯?섎뒗 寃쎌슦 V17 二쇱슂 ?꾩닔 ??ぉ? ?ㅼ쓬怨?媛숈뒿?덈떎.
name,display_name,version,category_keydescription.function,when_to_use,when_not_to_use,io_limits- 3~10媛쒖쓽
example_queries read_only,destructive,idempotentparameters_schema.type: objectparameters_schema.additionalProperties: false- 媛??낅젰 property??
description
?낅젰쨌異쒕젰 Schema??ToolSchemaResolver媛 ?대끂?뚯씠?섏쓽 Schema 由ъ냼?ㅼ? ?몃씪??Schema, DTO?먯꽌 ?앹꽦??Schema瑜??댁꽍?⑸땲?? YAML ?뺤쓽媛 ?덉쑝硫?ToolRegistryHeartbeatSender媛 parameters_schema? output_schema瑜?蹂묓빀?섏뿬 理쒖쥌 硫뷀??곗씠?곕? 留뚮벊?덈떎.
?ㅽ뻾 ??Schema 寃利앹? MCP Java SDK??DefaultJsonSchemaValidator瑜??ъ슜?섎ʼn JSON Schema 2020-12 湲곗??쇰줈 泥섎━?⑸땲?? ?낅젰 遺덉씪移섎뒗 422 INVALID_PARAM, 異쒕젰 遺덉씪移섎뒗 500 INVALID_TOOL_RESPONSE濡?諛섑솚?⑸땲?? ?? Schema ?댁꽍 ?먮뒗 寃利앷린 ?먯껜?먯꽌 ?덉쇅媛 諛쒖깮?섎㈃ ?꾩옱 援ы쁽? ?ㅻ쪟瑜?濡쒓렇??湲곕줉?섍퀬 ?대떦 寃利앹쓣 嫄대꼫?곷땲??
濡쒖뺄 ?ㅽ뻾
?ъ쟾 議곌굔
- JDK 21
- ?꾨줈?앺듃???ы븿??Gradle Wrapper
- Redis ?먮뒗 ?몃? ?곕룞???꾩슂??寃쎌슦 Docker
湲곕낯 ?쒖꽦 ?꾨줈?꾩? local?낅땲?? 濡쒖뺄 ?꾨줈?꾩? H2 硫붾え由?DB? P6Spy瑜??ъ슜?⑸땲??
$env:SPRING_PROFILES_ACTIVE = 'local'
$env:TOOL_SERVER_API_KEY = 'tool-server-key'
TOOL_SERVER_API_KEY瑜?吏?뺥븯吏 ?딆쑝硫??꾩옱 媛쒕컻 湲곕낯媛믪씤 tool-server-key媛 ?ъ슜?⑸땲?? ?댁쁺 ?섍꼍?먯꽌??湲곕낯媛믪쓣 ?ъ슜?섏? 留먭퀬 DATMS??Tool Server API Key? ?숈씪??蹂꾨룄 Secret??二쇱엯?댁빞 ?⑸땲??
媛?Pod??蹂꾨룄 ?곕??먯뿉???ㅽ뻾?⑸땲??
# ?곸뾽 Tool Pod
$env:AXHUB_TOOL_URL = 'http://localhost:8082'
.\gradlew.bat :dat-was-sal:bootRun
# 怨좉컼 Tool Pod
$env:AXHUB_TOOL_URL = 'http://localhost:8084'
.\gradlew.bat :dat-was-cus:bootRun
# ?곹뭹 Tool Pod
$env:AXHUB_TOOL_URL = 'http://localhost:8085'
.\gradlew.bat :dat-was-pro:bootRun
# ?쒖뒪??Tool Pod
$env:AXHUB_TOOL_URL = 'http://localhost:8086'
.\gradlew.bat :dat-was-sys:bootRun
?ㅽ뻾 ??SYS Pod 湲곗? ?뺤씤 URL? ?ㅼ쓬怨?媛숈뒿?덈떎.
http://localhost:8086/mcp/api/v1/tools/local
http://localhost:8086/tool-manifest
http://localhost:8086/swagger-ui/index.html
二쇱슂 ?섍꼍 蹂??
| ?섍꼍 蹂?? | ?ㅻ챸 | 湲곕낯媛? |
|---|---|---|
SPRING_PROFILES_ACTIVE |
Spring ?쒖꽦 ?꾨줈?? | local |
PORT |
Pod ?섏떊 ?ы듃 | 紐⑤뱢蹂?湲곕낯 ?ы듃 |
TOOL_SERVER_API_KEY |
DATMS媛 X-Tool-Server-API-Key濡??꾨떖??怨듯넻 ?몄쬆 Key |
tool-server-key |
AXHUB_TOOL_URL |
Manifest??Tool endpoint ?앹꽦???ъ슜??Pod ?몃? URL | http://localhost:${server.port} |
AXHUB_GATEWAY_URL |
?꾨줈??諛?Compose ?명솚??Gateway URL. ?꾩옱 DATMT??push ?깅줉?먮뒗 ?ъ슜?섏? ?딆쓬 | http://localhost:8081 |
SPRING_DATA_REDIS_HOST |
Redis ?몄뒪?? | localhost |
SPRING_DATA_REDIS_PORT |
Redis ?ы듃 | 6379 |
GLOW_COMMUNICATION_MCI_HOST |
MCI ????몄뒪?? | ?꾨줈?꾨퀎 ?ㅼ젙 |
GLOW_COMMUNICATION_MCI_PORT |
MCI ????ы듃 | ?꾨줈?꾨퀎 ?ㅼ젙 |
mcp.security.api-key???⑥씪 DATMS 怨듯넻 Key瑜? mcp.security.api-keys??API Key ??tenant ID ?뺥깭???ㅼ쨷 Key瑜?吏?먰빀?덈떎. ApiKeyInterceptor??Spring MVC媛 泥섎━?섎뒗 /rpc/**, /mcp/** ?붿껌???곸슜?섎?濡?REST /mcp/{toolName}怨?/mcp/api/v1/tools/local? ?щ컮瑜?X-Tool-Server-API-Key媛 ?놁쑝硫?401 Unauthorized媛 ?⑸땲?? ???ㅼ젙??紐⑤몢 鍮꾩뼱 ?덉쓣 ?뚮뒗 ?대떦 MVC ?붿껌???듬챸?쇰줈 ?덉슜?⑸땲?? ?꾩옱 ???낅Т Pod??湲곕낯 application.yml? ?⑥씪 Key瑜??ㅼ젙?⑸땲??
諛섎㈃ /mcp? /mcp/message??蹂꾨룄 Servlet?쇰줈 ?깅줉?섏뼱 Spring MVC HandlerInterceptor瑜??듦낵?섏? ?딆뒿?덈떎. ?꾩옱 援ы쁽留뚯쑝濡쒕뒗 ????MCP Streamable HTTP 寃쎈줈??ApiKeyInterceptor ?몄쬆???곸슜?섏? ?딆쑝誘濡? ?댁쁺 諛고룷 ??Servlet Filter ?먮뒗 ?꾩슜 MCP ?몄쬆 怨꾩링??異붽??댁빞 ?⑸땲??
Scaffold
怨듯넻 ?쇱씠釉뚮윭由щ뒗 ??Tool怨???Tool Pod瑜?留뚮뱶????媛쒖쓽 Java CLI瑜??쒓났?⑸땲?? ???대옒?ㅼ쓽 main 硫붿꽌?쒕? IDE?먯꽌 ?ㅽ뻾?섍굅???꾩슂???몄옄瑜??꾨떖???ㅽ뻾?????덉뒿?덈떎.
| Scaffolder | ??븷 | 二쇱슂 ?앹꽦쨌?섏젙 ??? |
|---|---|---|
ToolScaffolder |
湲곗〈 Pod??Tool 援ы쁽 異붽? | UseCase, DTO, Converter, Mock ?묐떟, V17 Tool YAML, ?곕룞 ?ㅼ젙 |
PodScaffolder |
???ㅽ뻾 Pod 紐⑤뱢 異붽? | 紐⑤뱢 ?붾젆?곕━, build.gradle, Dockerfile, Application ?대옒?? ?꾨줈???ㅼ젙, settings.gradle, docker-compose.yml |
PodScaffolder???몄옄 ?쒖꽌???ㅼ쓬怨?媛숈뒿?덈떎.
PodScaffolder <module-name> <port> [author] [yyyy.MM.dd]
?덈? ?ㅼ뼱 payment 8099瑜??낅젰?섎㈃ dat-was-payment 紐⑤뱢???앹꽦?⑸땲?? ?앹꽦?섎뒗 application.yml?먮뒗 ?ㅼ쓬 怨꾩빟???ы븿?⑸땲??
mcp:
manifest:
bundle-id: dat-was-payment
name-prefix: ""
security:
api-key: ${TOOL_SERVER_API_KEY:tool-server-key}
?앹꽦?섎뒗 Compose ?쒕퉬?ㅼ뿉??TOOL_SERVER_API_KEY=${TOOL_SERVER_API_KEY:-tool-server-key}媛 異붽??⑸땲?? ?앹꽦 ?꾩뿉???ㅼ쓬 ??ぉ??諛섎뱶???뺤씤?댁빞 ?⑸땲??
bundle-id瑜?DATMS???깅줉??bundle ID? ?쇱튂?쒗궢?덈떎.- ?댁쁺 ?섍꼍??
TOOL_SERVER_API_KEY瑜?DATMS媛 ?꾨떖?섎뒗 Key? ?숈씪??Secret?쇰줈 ?ㅼ젙?⑸땲?? - ?ㅼ젣 諛고룷 二쇱냼??留욊쾶
AXHUB_TOOL_URL???ㅼ젙?⑸땲?? - MCI쨌EAI쨌HTTP ?곕룞 ??곴낵 timeout???섍꼍蹂??ㅼ젙?쇰줈 援먯껜?⑸땲??
validateMcpToolNames? 紐⑤뱢쨌?꾩껜 ?뚯뒪?몃? ?ㅽ뻾?⑸땲?? YAML ?뺤쓽瑜?異붽??덈떎硫?ToolSchemaV17ValidationRunner?먮뒗 愿???뚯뒪?몃줈 V17 ??ぉ??蹂꾨룄 寃利앺빀?덈떎.
?뚯뒪?몄? 寃利?
# ?댁쁺 ?뚯뒪 ?꾩껜 而댄뙆??
.\gradlew.bat classes
# ?꾩껜 ?뚯뒪??
.\gradlew.bat test
# 紐⑤뱢蹂??뚯뒪??
.\gradlew.bat :dat-was-lib:test
.\gradlew.bat :dat-was-cus:test
.\gradlew.bat :dat-was-sal:test
.\gradlew.bat :dat-was-pro:test
.\gradlew.bat :dat-was-sys:test
# Tool ?대쫫쨌以묐났 寃??
.\gradlew.bat validateMcpToolNames
# 寃利? ?뚯뒪?? ?⑦궎吏?
.\gradlew.bat clean build
?ㅽ뻾 ???뺤씤
?뚯뒪???섏? ?깃났 ?щ????뚯뒪 蹂寃쎌뿉 ?곕씪 ?щ씪吏誘濡?怨좎젙???섏튂瑜?臾몄꽌?뷀븯吏 ?딆뒿?덈떎. 諛고룷 ???꾩옱 ?묒뾽 ?몃━?먯꽌 ?ㅼ쓬 紐낅졊???ㅽ뻾???뺤씤?⑸땲??
.\gradlew.bat test validateMcpToolNames
Docker Compose
docker-compose.yml? DATMT?????낅Т Pod留??뺤쓽?⑸땲??
| ?쒕퉬?? | 而⑦뀒?대꼫 ?ы듃 | ?몄뒪???ы듃 |
|---|---|---|
was-sal |
8082 | 8282 |
was-cus |
8084 | 8284 |
was-pro |
8085 | 8285 |
was-sys |
8086 | 8286 |
紐⑤뱢 Dockerfile? ?ъ쟾???앹꽦??Boot JAR瑜??대?吏??蹂듭궗?⑸땲?? 癒쇱? JAR瑜?鍮뚮뱶????Compose瑜??ㅽ뻾?⑸땲??
.\gradlew.bat :dat-was-sal:bootJar :dat-was-cus:bootJar :dat-was-pro:bootJar :dat-was-sys:bootJar
docker compose up --build
Compose ?뚯씪???⑸룄? ?꾩옱 二쇱쓽?먯? ?ㅼ쓬怨?媛숈뒿?덈떎.
| ?뚯씪 | ?⑸룄 | ?꾩옱 ?뚯뒪 湲곗? 二쇱쓽?? |
|---|---|---|
docker-compose.yml |
DATMT ??Pod ?⑤룆 ?ㅽ뻾 | gateway ?쒕퉬?ㅺ? ?놁?留?push ?깅줉???쒓굅?섏뼱 DATMT ?쒖옉?먮뒗 ?꾩슂?섏? ?딆쓬 |
docker-compose.local.yml |
DATMS? DATMT??濡쒖뺄 ?듯빀 援ъ꽦 | ????μ냼媛 媛숈? ?곸쐞 ?붾젆?곕━???덈뒗 援ъ“瑜?媛?? |
docker-compose.prod.yml |
DATMS? DATMT??媛쒕컻 ?꾨줈??湲곕컲 OCI 援ъ꽦 | ??μ냼??runner ?깅줉 ?좏겙???댁쁺 Secret?쇰줈 遺꾨━?댁빞 ?? |
docker-compose.local.yml怨?docker-compose.prod.yml??build context??媛곴컖 ./dat-was-DATMS, ./dat-was-datmt?낅땲?? ?꾩옱 ?뚯씪 ?꾩튂?먯꽌 ?ъ슜???뚮뒗 context 湲곗???????μ냼???곸쐞 ?붾젆?곕━濡?留욎떠???⑸땲??
# DATMT ??μ냼 ?붾젆?곕━?먯꽌 ?ㅽ뻾
docker compose --project-directory .. -f docker-compose.local.yml up --build
?꾩옱 湲곗〈 ??Pod??Compose ?뺤쓽?먮뒗 TOOL_SERVER_API_KEY ?섍꼍 蹂???꾨떖???놁뒿?덈떎. ?곕씪??而⑦뀒?대꼫???좏뵆由ъ??댁뀡 湲곕낯媛?tool-server-key瑜??ъ슜?⑸땲?? ?댁쁺 諛고룷 ??媛??쒕퉬?ㅼ뿉 Secret 湲곕컲 TOOL_SERVER_API_KEY ?꾨떖 ?ㅼ젙??異붽??섍퀬 DATMS??Key? ?쇱튂?쒖폒???⑸땲?? DATMS??媛?Pod??AXHUB_TOOL_URL ?먮뒗 諛고룷 URL???묎렐??/tool-manifest瑜?pull?????덉뼱???⑸땲??
OpenShift (Kubernetes) 諛고룷
OpenShift 媛쒕컻 ?섍꼍??Kustomize 留ㅻ땲?섏뒪?몃뒗 k8s/???덉뒿?덈떎. ??곸? DATMT????Tool Pod肉먯씠硫?DATMS(Gateway)??Deployment쨌Service쨌Route??????μ냼?먯꽌 留뚮뱾吏 ?딆뒿?덈떎.
k8s/
?쒋? base/ # ??Pod 怨듯넻 ConfigMap, Service, Deployment
?붴? overlays/dev/ # 媛쒕컻 namespace, Registry ?대?吏 寃쎈줈? tag
諛고룷 援ъ“
媛?Tool Pod??Deployment 1媛쒖? ?몃????몄텧?섏? ?딅뒗 ClusterIP Service 1媛쒕? ?ъ슜?⑸땲?? OpenShift Route? LoadBalancer Service???앹꽦?섏? ?딆쑝硫? Gateway媛 ?대윭?ㅽ꽣 ?대? DNS濡??몄텧?⑸땲??
| Service | Pod ?ы듃 | Gateway ?몄텧 二쇱냼 |
|---|---|---|
was-sal |
8082 | http://was-sal:8082 |
was-cus |
8084 | http://was-cus:8084 |
was-pro |
8085 | http://was-pro:8085 |
was-sys |
8086 | http://was-sys:8086 |
Gateway媛 ?ㅻⅨ namespace???덉쑝硫?was-sal.axhub-datmt-dev.svc? 媛숈? FQDN???ъ슜?섍퀬, NetworkPolicy?먯꽌 Gateway namespace??ingress瑜?蹂꾨룄濡??덉슜?댁빞 ?⑸땲??
諛섏쁺 ???ㅼ젙
?ㅼ쓬 媛믪? ?ㅼ젣 ?좏븳?쇱씠??媛쒕컻留?媛믪쑝濡?援먯껜?댁빞 ?⑸땲??
k8s/overlays/dev/kustomization.yaml??namespace, ?대? Container Registry 寃쎈줈, 諛고룷 image tagk8s/base/configmap.yaml??CHANGE_MEMCI쨌EXTMCI쨌EAI ?몄뒪??- ?ㅼ젣 Secret 媛?
datmt-runtime-secrets Secret? Git????ν븯吏 ?딄퀬 OpenShift namespace?먯꽌 蹂꾨룄濡??앹꽦?⑸땲?? 理쒖냼??TOOL_SERVER_API_KEY??DATMS媛 ?꾨떖?섎뒗 X-Tool-Server-API-Key? 媛숈? 媛믪씠?댁빞 ?⑸땲?? DB 怨꾩젙쨌鍮꾨?踰덊샇, API Key, ?몄쬆??鍮꾨?踰덊샇 ?깅룄 ??Secret?쇰줈 愿由ы빀?덈떎.
# runtime-secrets.env????μ냼 諛뽰뿉 蹂닿??⑸땲??
oc -n axhub-datmt-dev create secret generic datmt-runtime-secrets `
--from-env-file=runtime-secrets.env
Secret???놁쑝硫?媛?Deployment??envFrom.secretRef瑜??댁꽍?????놁뼱 Pod媛 ?쒖옉?섏? ?딆쓣 ???덉뒿?덈떎.
?대?吏 鍮뚮뱶? 諛고룷
紐⑤뱢 Dockerfile? 誘몃━ ?앹꽦??Boot JAR瑜?蹂듭궗?섎?濡? ?대?吏瑜?留뚮뱾湲??꾩뿉 ??紐⑤뱢??JAR瑜?鍮뚮뱶?⑸땲?? 媛쒕컻留앹뿉?쒕뒗 JDK/JRE 踰좎씠???대?吏? Gradle/Maven ?섏〈?깆쓣 ?대? Registry쨌Nexus?먯꽌 ?ъ슜?????덉뼱???⑸땲??
.\gradlew.bat :dat-was-sal:bootJar :dat-was-cus:bootJar :dat-was-pro:bootJar :dat-was-sys:bootJar
# OpenShift 濡쒓렇??諛?project ?좏깮 ??
oc kustomize k8s/overlays/dev
oc apply -k k8s/overlays/dev
oc get deployment,pod,svc -n axhub-datmt-dev
?곸슜 ?꾩뿉??oc kustomize k8s/overlays/dev | oc apply --dry-run=client -f -濡??쒕쾭 痢??ㅽ궎留?寃利앹쓣 ?섑뻾?⑸땲?? ?꾩옱 留ㅻ땲?섏뒪?몄쓽 readiness/liveness probe??TCP ?ы듃 ?뺤씤 諛⑹떇?낅땲?? Actuator health endpoint瑜?異붽????ㅼ뿉??HTTP readiness/liveness probe濡?蹂寃쏀븯??寃껋쓣 沅뚯옣?⑸땲??
?곸꽭??紐낅졊怨?Gateway ?곌껐 ?뺤씤 諛⑸쾿? k8s/README.md瑜?李멸퀬?⑸땲??
蹂댁븞 諛??댁쁺 二쇱쓽?ы빆
?꾩옱 援ы쁽???댁쁺 ?섍꼍???몄텧?섍린 ?꾩뿉 ?꾨옒 ??ぉ??諛섎뱶???먭??댁빞 ?⑸땲??
- API Key ?명꽣?됲꽣??Spring MVC??
/rpc/**,/mcp/**Handler???곸슜?⑸땲?? REST/mcp/{toolName}怨?/mcp/api/v1/tools/local? ?몄쬆 ??곸엯?덈떎. - 蹂꾨룄 Servlet??
/mcp,/mcp/message??MVC ?명꽣?됲꽣瑜??고쉶?섎?濡??꾩옱 API Key ?몄쬆 ??곸씠 ?꾨떃?덈떎. ?댁쁺 ?몄텧 ?꾩뿉 蹂꾨룄 ?몄쬆??異붽??댁빞 ?⑸땲?? /tool-manifest?/tool-manifest/{categoryKey}?????명꽣?됲꽣 寃쎈줈 諛뽰뿉 ?덉뼱 ?꾩옱 API Key ?몄쬆 ??곸씠 ?꾨떃?덈떎. ?대?留씲텶ngress ?뺤콉 ?먮뒗 蹂꾨룄 ?몄쬆???꾩슂?쒖? ?댁쁺 湲곗????뺤씤?댁빞 ?⑸땲??- ???낅Т Pod??湲곕낯 Key??紐⑤몢
tool-server-key?낅땲?? ?댁쁺?먯꽌??諛섎뱶??蹂꾨룄 Secret?쇰줈 援먯껜?섍퀬 DATMS??X-Tool-Server-API-Key媛믨낵 ?쇱튂?쒖폒???⑸땲?? - ?ㅼ젙???⑥씪 Key? ?ㅼ쨷 Key媛 紐⑤몢 ?놁쓣 ?뚮쭔 ?듬챸 ?붿껌???덉슜?⑸땲??
mcp.security.tenant-domains???ㅼ젙 媛앹껜??諛붿씤?⑸릺吏留?Tool蹂??멸????ъ슜?섏? ?딆뒿?덈떎.requiresApproval? 硫뷀??곗씠?곗뿉留?湲곕줉?섎ʼn ?ㅽ뻾 李⑤떒?대굹 ?뱀씤 ?뺤씤 濡쒖쭅? ?놁뒿?덈떎.- ?낅젰쨌異쒕젰 Schema 泥섎━ ?먯껜?먯꽌 ?덉쇅媛 諛쒖깮?섎㈃ ?꾩옱 ?ㅽ뻾 ?쒕퉬?ㅻ뒗 濡쒓렇瑜??④린怨?寃利앹쓣 嫄대꼫?곷땲??
- CORS??紐⑤뱺 Origin???덉슜?섎㈃??credential???덉슜?섎룄濡??ㅼ젙?섏뼱 ?덉뒿?덈떎. ?댁쁺 Origin??紐낆떆?곸쑝濡??쒗븳?댁빞 ?⑸땲??
docker-compose.prod.yml??runner ?깅줉 ?좏겙???됰Ц?쇰줈 ?ы븿?섏뼱 ?덉뒿?덈떎. ?ъ슜 以묒씤 ?좏겙? ?먭린쨌?щ컻湲됲븯怨?諛고룷 Secret?쇰줈 ?댁쟾?댁빞 ?⑸땲??- Tool ?붿껌怨??곕룞 ?ㅻ쪟 濡쒓렇??媛쒖씤?뺣낫???몄쬆?뺣낫媛 ?ы븿?섏? ?딅룄濡?DTO? 濡쒓렇 留덉뒪???뺤콉??寃?좏빐???⑸땲??
二쇱슂 ?뚯뒪 ?꾩튂
| 二쇱젣 | ?꾩튂 |
|---|---|
| 怨듯넻 鍮뚮뱶 諛?寃利??묒뾽 | build.gradle |
| REST Tool ?ㅽ뻾 API | dat-was-lib/src/main/java/io/shinhanlife/dat/mcc/presentation/BusinessToolController.java |
| ?붿껌 ?ㅻ뜑 罹≪쿂쨌?꾨떖 | dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/McpRequestHeaderFilter.java, McpRequestHeaderContext.java |
| Tool ?ㅽ뻾 ?쒕퉬?? | dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/McpToolExecutionService.java |
| JSON Schema 2020-12 寃利??ㅼ젙 | dat-was-lib/src/main/java/io/shinhanlife/dat/lib/config/ToolSchemaConfiguration.java |
| ?ㅽ뻾 硫붿꽌??Registry | dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/McpToolMethodRegistry.java |
| MCP SDK ?쒕쾭 | dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/ToolMcpServerConfiguration.java |
| MCP Tool ?숆린?? | dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/ToolPodMcpToolSynchronizer.java |
| Tool ?ㅼ틪 諛?硫뷀??곗씠???앹꽦 | dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/ToolRegistryHeartbeatSender.java |
| YAML Tool ?뺤쓽 濡쒕뵫 | dat-was-lib/src/main/java/io/shinhanlife/dat/lib/metadata/ToolDefinitionRepository.java |
| V17 ?뺤쓽 寃利? | dat-was-lib/src/main/java/io/shinhanlife/dat/lib/metadata/ToolDefinitionValidator.java |
| Manifest ?앹꽦 | dat-was-lib/src/main/java/io/shinhanlife/dat/lib/manifest/ToolManifestService.java |
| API Key ?명꽣?됲꽣 | dat-was-lib/src/main/java/io/shinhanlife/dat/lib/mcp/security/ApiKeyInterceptor.java |
| Tool쨌Pod ?ㅼ틦?대뵫 | dat-was-lib/src/main/java/io/shinhanlife/dat/lib/util/ToolScaffolder.java, PodScaffolder.java |
媛쒕컻 ??沅뚯옣 ?뺤씤 ?쒖꽌
- Tool 硫붿꽌?쒖? ?붿껌쨌?묐떟 DTO瑜?援ы쁽?⑸땲??
- ?숈씪 ?대쫫??V17 YAML ?뺤쓽瑜?
tool-definitions?꾨옒??異붽??⑸땲?? validateMcpToolNames? 紐⑤뱢쨌?꾩껜 ?뚯뒪?몃? ?ㅽ뻾?⑸땲?? Tool YAML ?뺤쓽瑜?異붽???寃쎌슦?먮뒗 V17 ??ぉ??蹂꾨룄 寃利앺빀?덈떎.- 紐⑤뱢 ?뚯뒪?몄? ?꾩껜 ?뚯뒪?몃? ?ㅽ뻾?⑸땲??
- 濡쒖뺄 Pod?먯꽌
/mcp/api/v1/tools/local怨?/tool-manifest瑜??뺤씤?⑸땲?? - DATMS??bundle ID, Pod Manifest URL, Tool Server API Key媛 DATMT ?ㅼ젙怨??쇱튂?섎뒗吏 ?뺤씤?⑸땲??
- REST? MCP ?묒そ?먯꽌 ?숈씪??Tool 寃곌낵쨌?붿껌 ?ㅻ뜑 ?꾨떖쨌?ㅻ쪟 怨꾩빟???뺤씤?⑸땲??