altair823
16b4f9fb9f
- P9 dogfooding 백로그 항목 fb-26 ~ fb-42 추가 - 각 항목의 목표, 증상, 후속 작업 및 위험 요소 명시 - release 계획에 따른 0.3.0 ~ 0.6.0 분할 📝 docs(INDEX): 백로그 항목에 대한 세부 정보 추가 - fb-26 ~ fb-42 항목의 세부 정보 및 상태 추가 - 각 항목의 목표와 후속 작업 명시 - 도그푸딩 피드백에 따른 개선 사항 반영 🔧 chore(tasks): 새로운 백로그 항목 파일 생성 - p9-fb-26 ~ p9-fb-42 각 항목에 대한 개별 파일 생성 - 각 파일에 목표, 증상, 후속 작업 및 위험 요소 포함 - doogfooding 피드백을 기반으로 한 개선 사항 문서화
45 lines
2.3 KiB
Markdown
45 lines
2.3 KiB
Markdown
---
|
|
phase: P9
|
|
component: integrations + new crate (kebab-mcp)
|
|
task_id: p9-fb-30
|
|
title: "MCP server — agent host 무관 protocol surface"
|
|
status: open
|
|
target_version: 0.3.0
|
|
depends_on: [p9-fb-27, p9-fb-29]
|
|
unblocks: []
|
|
contract_source: ../../docs/superpowers/specs/2026-04-27-kebab-final-form-design.md
|
|
contract_sections: [§7 RAG, §10 UX, externalAI 통합 절]
|
|
source_feedback: 사용자 도그푸딩 2026-05-06 — Claude Code 같은 AI agent 가 kebab CLI 를 사용하는 것이 궁극 목표. 현재 surface 는 Claude Code 전용 skill (subprocess wrapper) 만 — host 무관 표준 통신 없음.
|
|
---
|
|
|
|
# p9-fb-30 — MCP server
|
|
|
|
> ⏳ **백로그 only — 미구현.** 본 spec 은 도그푸딩 피드백 skeleton. 구현 착수 전 [superpowers:brainstorming](../../docs/superpowers/) 으로 설계 단계 선행 필요. transport 선택 (stdio / socket) / tool surface 범위 / authentication / resources vs tools 매핑 brainstorm 후 확정.
|
|
|
|
## 증상 / 동기
|
|
|
|
- 현재 외부 AI 통합은 `integrations/claude-code/kebab/` skill 한 종류 — Claude Code subprocess wrapper.
|
|
- Cursor / OpenAI Agents / Copilot CLI 등 다른 host 는 별도 wrapper 작성 필요.
|
|
- MCP (Model Context Protocol) 가 표준 — 한 번 server 구현하면 MCP-aware host 모두 지원.
|
|
|
|
## Goal (skeleton)
|
|
|
|
- `kebab mcp` subcommand 또는 별도 binary `kebab-mcp` — stdio MCP server.
|
|
- Tool surface (최소): `search`, `ask`, `fetch`, `ingest_file`, `ingest_stdin`, `stats`, `schema`.
|
|
- Resources: 옵션 — chunk / doc 을 MCP resource 로 노출 (host subscribe 가능).
|
|
- Prompts: 옵션 — agent 가 재사용 가능한 prompt template (예: "summarize this KB section").
|
|
- skill 과 병행 — skill 은 backward compat, 신규는 MCP 권장.
|
|
|
|
## 후속 작업 — brainstorm 필요 항목
|
|
|
|
- transport: stdio default, http (fb-29 daemon) 위에 SSE 옵션.
|
|
- tool 이름 / 인자 스키마 — wire schema v1 재사용 가능?
|
|
- authentication — local-only 면 무인증, daemon 위면 token.
|
|
- 새 crate `kebab-mcp` 위치 / 의존성 boundary (kebab-app facade 만 import).
|
|
|
|
## Risks / notes
|
|
|
|
- MCP spec 진화 중 — 버전 lock 명시 필요.
|
|
- skill 과 surface 중복 — 사용자 혼란 방지 README 안내.
|
|
- fb-29 (daemon) 선행 또는 동시 — daemon 모드 위에 MCP HTTP 변형 가능.
|