koseokmin
cb29b192b4
5cfb8a1이 .gitignore에 docs/를 넣고 68개 파일을 지웠다. 그런데
AgentBuilderContractExampleTest, ToolBundleContractExampleTest,
ArchitectureDocumentContractTest는 docs/ 아래 계약 예제와 architecture
문서를 입력으로 직접 읽는다. 그 결과 clean clone에서 테스트 10건이
입력을 찾지 못해 실패했다.
제외 범위를 원래 의도대로 좁힌다. 에이전트 산출물(AGENTS.md, .agents/,
.codex/, docs/superpowers/)은 계속 제외하고 저장소 문서는 추적한다.
문서는 삭제 직전 상태(3de052a)를 기준으로 복원하고, 그 위에 main 코드와
대조해 어긋난 부분을 고쳤다.
- ADR-0007을 Superseded로 바꾸고 ADR-0013을 새로 쓴다. route당 Tool
Service N개가 최종안이며, PortalToolRegistryClient가 이미 route별로
N개를 유지하고 있는데 ADR-0007은 "bundles는 항상 한 항목"을 Accepted
상태로 주장하고 있었다. ADR-0009 결정 4도 부분 대체한다.
- ADR-0008 파일 헤더가 Accepted였으나 ADR-0009가 이미 대체한 상태였다.
- 6078852의 endpoint 소유권 반전이 반영되지 않은 서술을 계약 v0.2,
bundle 설정 예제, Tool 적재 안내에서 고친다.
- Portal registry 계약 v0.1과 route key 규약을 새로 문서화한다. 둘 다
구현은 있는데 계약 문서가 없었다.
- MCP SDK 2.0.0 SBOM을 추가한다.
번호 주석: ADR-0011과 0012는 feature/mcp-integration이 Tool inputSchema
정책에 쓰고 있어 비워 둔다.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
52 lines
2.5 KiB
YAML
52 lines
2.5 KiB
YAML
# MCP Server의 bundle 조회 설정 예시 (protocol-v0.2-bundle-discovery.md 3절)
|
|
#
|
|
# 이 파일은 계약 예시이며 실제 적용 설정이 아니다.
|
|
# 운영에서는 ConfigMap으로 주입하고 MCP Server마다 다른 bundle 목록을 갖는다.
|
|
#
|
|
# 키 이름은 구현된 McpProperties와 1:1로 맞춰 두었다. Spring relaxed binding이
|
|
# camelCase와 kebab-case를 모두 받으므로 이 문서는 읽기 쉬운 camelCase를 쓴다.
|
|
|
|
mcp:
|
|
# 이 MCP Server의 식별자. Redis key namespace에 사용한다.
|
|
identity: mcp-insurance-core
|
|
|
|
registry:
|
|
# 조회 주기와 첫 scheduled refresh 쏠림을 줄이는 지연 jitter. 기동 preload는 즉시 실행한다.
|
|
refreshIntervalSeconds: 30
|
|
refreshJitterSeconds: 5
|
|
|
|
discovery:
|
|
# 운영 profile에서는 true이고 아래 Tool Service 매니페스트만 원천으로 사용한다.
|
|
# false는 local profile의 테스트 JSON에만 사용한다.
|
|
enabled: true
|
|
|
|
connectTimeoutMillis: 1000
|
|
readTimeoutMillis: 3000
|
|
|
|
# 상한. 초과 시 처리는 계약 7절을 따른다.
|
|
maxToolsPerBundle: 100
|
|
maxToolsTotal: 200
|
|
maxManifestBytes: 1048576
|
|
|
|
# 매니페스트가 선언한 Tool timeout의 상한. 초과분은 절삭한다.
|
|
# Tool이 과도한 timeout을 선언해 MCP 스레드를 점유하는 것을 막는다.
|
|
maxToolTimeoutMillis: 30000
|
|
|
|
# 스키마는 N개를 허용하지만 운영 배포에서는 항상 한 항목이다.
|
|
# MCP 배포 하나가 Tool Service 하나만 보기 때문이다(ADR-0007).
|
|
# 대상을 늘리려면 이 목록이 아니라 MCP 배포를 하나 더 만든다.
|
|
bundles:
|
|
- id: insurance-processing
|
|
# 매니페스트 조회 주소 (MCP -> Tool)
|
|
manifestUrl: http://tool-processing.ax-hub.svc.cluster.local:8080/tool-manifest
|
|
# 매니페스트의 상대 endpoint를 절대 URL로 바꿀 때 쓰는 기준 주소.
|
|
# Pod IP가 아니라 Service URL을 사용한다.
|
|
# Tool 실행 주소 자체는 매니페스트의 endpoint 또는 _meta.endpoint가 정한다(ADR-0010).
|
|
# 매니페스트가 절대 URL을 쓰면 해석에는 쓰이지 않지만, 그때도 절대 HTTP(S)여야 한다.
|
|
baseEndpoint: http://tool-processing.ax-hub.svc.cluster.local:8080/mcp
|
|
# Tool Service가 선언한 표준 MCP name이 따라야 할 접두사.
|
|
# 업무 단위이며 중요도 등급을 넣지 않는다. 등급이 이름에 들어가면
|
|
# Tool 재분류가 Tool name 변경이 되어 Agent Builder 재등록을 부른다.
|
|
namePrefix: "processing."
|
|
enabled: true
|