Sprint 5 종료: MCP Server
요약
Meronq의 Sprint 5가 종료됨에 따라 MCP(Model Context Protocol) 서버 기능이 구현되었습니다. 이를 통해 AI 어시스턴트가 Meronq를 제품 도구 계층으로서 활용하여 프로젝트에 연결하고 다양한 도구를 사용할 수 있습니다.
핵심 포인트
- MCP 도구 인터페이스 및 제품 서버(v1.1.0) 구현 완료
- 제품용 MCP와 로컬 MCP의 명확한 구분 및 사용 시점 정의
- 공유 로직을 담은 @meronq/server-core 패키지 출시
- 환경 변수를 활용한 안전한 권한 및 네트워크 모델 적용
- SQLite 기반의 메모리 검색 기능 제공
Sprint 5가 종료되었습니다.
목표는 MCP를 통해 Meronq의 역량을 노출하여, AI 어시스턴트가 Meronq 자체를 개발할 때뿐만 아니라 제품 도구 계층 (product tool layer)으로서 Meronq를 사용할 수 있도록 하는 것이었습니다. 이전 스프린트에서 다루었던 GitHub 데이터와 로컬 메모리는 이제 명시적인 권한 모델 (permission model)을 갖춘 전용 제품 서버 (product server)를 통해 제공됩니다.
Sprint 5의 성과
로드맵의 모든 항목이 완료되었습니다:
- MCP 도구 인터페이스 (tool surface) — 핸드셰이크 (handshake), 스캔 (scan), 메모리 (memory), GitHub, 런타임 (runtime), 그리고 git 읽기 (git read) 도구
- 제품 서버 (Product server) — Meronq가 활성화된 모든 리포지토리를 위한
apps/mcp-serverv1.1.0 - 공유 서버 코어 (Shared server core) —
@meronq/server-core(핸드셰이크, 권한, 런타임, CEM 동기화) - 메모리 검색 (Memory search) — SQLite 기반의
memory_search및memory_stats - 안전 모델 (Safety model) — 환경 변수를 통한 런타임 및 네트워크 게이트 (gates)
로컬 MCP는 dogfooding 도구(git write, 소셜 배포, 확장된 허용 목록)를 유지하면서 @meronq/server-core (v1.15.0)로 리팩토링되었습니다.
제품용 MCP vs 로컬 MCP
| 인터페이스 (Surface) | 사용 시점 |
|---|---|
apps/mcp-server | 어시스턴트를 당신의 프로젝트에 연결할 때 |
apps/local-mcp | Meronq 자체를 개발할 때 (소셜, git write, dogfooding) |
MERONQ_PROJECT_PATH(또는 MERONQ_PATH)를 사용하여 두 서버 중 하나를 리포지토리에 지정하십시오.
새로운 패키지: @meronq/server-core
로컬 MCP에서 추출된 공유 로직:
| 모듈 | 역할 |
|---|---|
buildHandshake() | CEM, 메모리, GitHub, 스프린트 컨텍스트를 포함한 온보딩 페이로드 (onboarding payload) |
| ... |
제품용 MCP는 memory_search, github_sync, project_build 및 허용 목록에 포함된 명령어를 포함하여 14개의 도구를 노출합니다. 설계상 Git write는 제품 인터페이스에서 제외되어 있습니다.
권한 모델 (Permission model)
MERONQ_ALLOW_RUNTIME=true → build, test, install/dev 허용 목록
MERONQ_ALLOW_NETWORK=true → GitHub API 갱신 (또는 GITHUB_TOKEN 설정)
읽기 전용 (Read-only) git 도구(git_status, git_diff)는 추가 플래그 없이 작동합니다. Cursor 설정에 대해서는 MCP server guide를 참조하세요.
메모리 검색 (Memory search)
memory_search는 선택적인 타입 필터와 함께 .meronq/local/memory.db 내의 엔티티 (entities)를 쿼리합니다. 결과가 반환될 때 액세스 이벤트 (access events)가 기록되며, 이는 ADR-0005와 일치합니다.
# MCP: memory_search { "query": "github", "limit": 10 }
Sprint 6 — 기술 및 워크플로 (Skills and Workflows)
Sprint 6 목표: 재사용 가능한 절차적 엔지니어링 지식 (reusable procedural engineering knowledge) 도입 — MCP 및 CLI에서 호출 가능한 버전 관리된 프로젝트 기술 (Project Skills)인 project.build, project.test, adr.create를 제공합니다.
제품 MCP 인터페이스 (surface)는 활성화되었으며, Sprint 6는 그 위에 결정론적 워크플로 (deterministic workflows)를 추가합니다.
팔로우하기 (Follow along)
- Roadmap — 스프린트 계획 (sprint plan)
- MCP server setup
- Development blog
- GitHub: Meronq-dev/meronq
Sprint 4가 GitHub를 연결했습니다. Sprint 5는 프로젝트 지능 (project intelligence)을 휴대 가능하게 만들었습니다. Sprint 6는 어시스턴트에게 반복 가능한 엔지니어링 작업을 수행하는 _방법_을 가르칩니다.
전체 포스트 읽기: meronq.pages.dev · GitHub 소스
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기