From c606e39abe7ff6ba68b8460ea424fc13062aeddd Mon Sep 17 00:00:00 2001 From: kaffa Date: Tue, 28 Jul 2026 12:34:22 +0900 Subject: [PATCH] =?UTF-8?q?MCP=202026-07-28=20=EC=8B=A0=EA=B7=9C=20?= =?UTF-8?q?=EC=8A=A4=ED=8E=99=20=EA=B2=80=ED=86=A0=20=EA=B8=B0=EB=A1=9D=20?= =?UTF-8?q?(=EC=9E=90=EC=B2=B4=20=EC=9A=B4=EC=98=81=20=EC=84=9C=EB=B2=84?= =?UTF-8?q?=203=EC=A2=85=20=EC=98=81=ED=96=A5=20=ED=8F=89=EA=B0=80,=20RC?= =?UTF-8?q?=20=EC=83=81=ED=83=9C=20=ED=99=95=EC=9D=B8)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- dev/claude-code-setup.md | 6 +++- history/2026-07-28-mcp-2026-spec-review.md | 34 ++++++++++++++++++++++ 2 files changed, 39 insertions(+), 1 deletion(-) create mode 100644 history/2026-07-28-mcp-2026-spec-review.md diff --git a/dev/claude-code-setup.md b/dev/claude-code-setup.md index c1707de..2a04b4c 100644 --- a/dev/claude-code-setup.md +++ b/dev/claude-code-setup.md @@ -1,6 +1,6 @@ --- title: Claude Code 설정 및 인스트럭션 -updated: 2026-03-25 +updated: 2026-07-28 tags: [claude-code, setup, memory] --- @@ -47,6 +47,10 @@ tags: [claude-code, setup, memory] - 마운트된 엔진: `secret/` (KV), `ssh-client-signer/` (SSH) - 주요 용도: 시크릿 관리, PKI 인증서 발급, SSH 서명 +### MCP 2026-07-28 신규 스펙(stateless 전환) 검토 + +자체 운영 서버(incus-mcp, bunnycdn-mcp, vault-mcp-server) 영향 평가 완료 — 스펙 아직 RC 단계(정식 전환 미확인), SDK도 베타 상태라 즉시 업그레이드 불필요. 상세: [[../history/2026-07-28-mcp-2026-spec-review|history]] + ## 장기기억 Obsidian 단일 구조화 지식 정본 체계. _과거 OpenMemory(Mem0) 시멘틱 검색 계층을 병행했으나 2026-07-27 서비스 자체 폐기 — [[../history/2026-07-27-openmemory-decommission|history]]_ diff --git a/history/2026-07-28-mcp-2026-spec-review.md b/history/2026-07-28-mcp-2026-spec-review.md new file mode 100644 index 0000000..5d890a7 --- /dev/null +++ b/history/2026-07-28-mcp-2026-spec-review.md @@ -0,0 +1,34 @@ +--- +title: MCP 2026-07-28 신규 스펙 검토 — 자체 운영 서버 3종 영향 평가 +updated: 2026-07-28 +tags: [history, mcp, dev] +--- + +## 배경 + +MCP(Model Context Protocol) 사상 최대 개정판 `2026-07-28` 리비전 진행 중. **2026-07-28 시점 확인 결과 아직 Release Candidate 단계** — RC는 2026-05-21 lock, GitHub 릴리즈 태그 `2026-07-28-RC`(2026-05-29 게시)도 RC로 명시. 공식 블로그는 "정식 스펙은 2026-07-28에 발표 예정(ships on)"이라고만 되어 있고, 조사 시점 기준 정식(final/stable) 태그로 전환됐다는 근거는 확인 안 됨 — SDK도 전부 beta 라벨 유지. ⚠️ 정식 전환 여부는 추후 재확인 필요. + +핵심 변경(RC 기준): stateful → **stateless 프로토콜 코어** 전환, Extensions 프레임워크 신설, Tasks가 실험 코어 기능에서 Extension으로 이관, MCP Apps(서버 렌더링 UI) 추가, Authorization 강화(RFC 9207 `iss` 검증 등), **Roots/Sampling/Logging 3개 기능 deprecated**(annotation-only, 1년간 동작 유지). 공식 발표: [Model Context Protocol Blog — 2026-07-28 Release Candidate](https://blog.modelcontextprotocol.io/posts/2026-07-28-release-candidate/), [GitHub Releases](https://github.com/modelcontextprotocol/modelcontextprotocol/releases) + +## 조사 대상: 자체 운영 MCP 서버 3종 + +| 서버 | 소유 | 소스 | Transport | SDK | Deprecated 기능(Sampling/Roots/Logging) 사용 | +|------|------|------|-----------|-----|------| +| **incus-mcp** (`@ironclads/incus-mcp`) | 직접 작성·npm 퍼블리시 (kappa.andromeda) | (npm 패키지, gitea `kaffa/incus-mcp`) | stdio (로컬 프로세스) | `@modelcontextprotocol/sdk ^0.6.0` (구버전) | 미사용 | +| **bunnycdn-mcp** | 직접 작성 (Python FastMCP) | `gitea.inouter.com/kaffa/bunnycdn-mcp` | streamable-http | `mcp[cli]>=1.0.0` | 미사용 | +| **vault-mcp-server** (jp1 `/usr/local/bin/vault-mcp-server`) | **제3자 Go 바이너리** — kaffa gitea에 소스 없음 | 불명(외부 프로젝트, 다운로드 설치분으로 추정) | streamable-http | 불명 | 확인 불가 | + +## 판단 (2026-07-28 시점) + +- 신규 스펙은 아직 RC 단계(정식 전환 여부 미확인)이고 SDK가 전부 베타 → **즉시 업그레이드 불필요**, RC→final 전환 및 SDK GA 확인 후 재검토. +- 자체 작성한 incus-mcp·bunnycdn-mcp 모두 deprecated 기능(Sampling/Roots/Logging) 미사용 → deprecation 자체로는 영향 없음. +- incus-mcp는 stdio 전용이라 이번 개정 핵심(stateless HTTP 전환)과 애초에 무관. SDK 0.6.0이 오래된 건 별개 이슈(신규 스펙과 무관하게 언젠가 1.x로 갱신 권장, 급하지 않음). +- bunnycdn-mcp가 셋 중 유일하게 stateless 전환의 실질 대상(자체 소스 보유 + streamable-http). SDK v2 GA 이후 `FastMCP → MCPServer` 임포트 경로 변경 정도로 마이그레이션 부담 작을 것으로 예상. +- vault-mcp-server는 소스 미보유 → 직접 수정 불가, 업스트림 릴리스 여부 추적 필요. + +## Next Action (미조치) + +- [ ] MCP 스펙 RC → final 전환 여부 재확인 (blog.modelcontextprotocol.io, GitHub releases) +- [ ] MCP 공식 SDK GA(정식) 릴리스 공지 확인 후 bunnycdn-mcp 마이그레이션 재검토 +- [ ] vault-mcp-server 업스트림 프로젝트/저장소 출처 확인 (현재 불명 — 재설치 시 참고용으로 파악 필요) +- [ ] incus-mcp SDK 0.6.0 → 최신 1.x 갱신 (신규 스펙과 무관한 별도 유지보수 항목)