MCP 서버 통합 — 빌드 연습

2.4 MCP Server Integration의 CCA-F 준비 연습을 위한 스캐폴드입니다. 여기에는 해결된 것이 없습니다 — 아래의 모든 작업에는 채워야 할 TODO가 있습니다.

작업 체크리스트

• 1. 프로젝트 수준 구성 — .mcp.json에 github 서버 항목(command/args)이 있습니다. GitHub가 아니라면 원하는 커뮤니티 서버로 교체하세요.

• 2. 환경 변수 확장 — github 항목은 하드코딩된 자격 증명 대신 ${GITHUB_TOKEN}을 참조합니다. .env.example을 .env로 복사하고 실제 토큰을 입력하세요.

• 3. 사용자 수준 구성 — ~/.claude.json은 프로젝트 외부에 있고 사용자 머신에 개인적인 것이므로 의도적으로 여기에 생성하지 않았습니다. 템플릿 및 단계: docs/user-level-config.md.

• 4. MCP 리소스 노출 — src/server.ts에 스텁 catalogue://TODO 리소스가 있습니다. 적절한 URI, 이름, 설명, mimeType을 가진 실제 콘텐츠 카탈로그(예: DB 스키마 또는 문서 계층 구조)로 교체하세요.

• 5. 도구 설명 개선 — 같은 파일에서 example_tool에 자리 표시자 설명이 있습니다. 기능, 출력, 사용 사례, 내장 대안과의 비교를 다루는 3-5문장을 작성하세요.

Related MCP server: MCP Inspector Server

설정

npm install
npm run dev        # starts the stdio server directly
npm run inspect     # opens MCP Inspector against the server for manual testing

레이아웃

.mcp.json                   Task 1 & 2 — project-level server config
.env.example                Task 2 — template for the secret .mcp.json expands
docs/user-level-config.md   Task 3 — template + steps for ~/.claude.json
src/server.ts                Task 4 & 5 — custom MCP server with resource/tool stubs