MCP·Skill 내부 구조 실습 예시

// 요청 (Client → Server)
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": { "sampling": {}, "roots": { "listChanged": true } },
    "clientInfo": { "name": "claude-code", "version": "2026.06" }
  }
}

// 응답 (Server → Client)
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-06-18",
    "capabilities": { "tools": { "listChanged": true } },
    "serverInfo": { "name": "weather-server", "version": "1.0.0" }
  }
}

// 요청
{ "jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {} }

// 응답
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "tools": [
      {
        "name": "get_weather",
        "description": "도시 이름으로 현재 날씨를 조회한다",
        "inputSchema": {
          "type": "object",
          "properties": { "city": { "type": "string" } },
          "required": ["city"]
        }
      }
    ]
  }
}

// 요청
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "get_weather",
    "arguments": { "city": "Seoul" }
  }
}

// 응답
{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      { "type": "text", "text": "서울: 맑음, 24°C" }
    ]
  }
}

# 컨텍스트에 들어간 것 (스킬 100개 = 메타 100개)
- pdf-report: "재무 PDF에서 표를 추출해 요약. 사용자가 PDF 분석을 요청할 때 사용."
- commit-helper: "변경 diff로 커밋 메시지를 작성. 커밋을 만들 때 사용."
- ... (98개 더, 각 name + description 한 줄)

# 아직 컨텍스트에 없는 것
- 각 SKILL.md 본문, reference/*.md, scripts/*.py

# 사용자 발화
"이 분기 재무 PDF에서 핵심 표만 뽑아줘"

# 매칭 결과 → 컨텍스트에 추가로 들어간 것
SKILL.md (pdf-report) 본문 전체  ≈ 5K 토큰 미만
  - 절차 단계, 주의사항, reference/scripts 안내

# 여전히 컨텍스트에 없는 것
- 나머지 99개 스킬 본문, pdf-report의 reference/, scripts/

# 조건부로만 로드
reference/tables.md   → 본문이 가리킬 때만 읽어서 컨텍스트에 추가

# 스크립트: 코드는 컨텍스트에 안 올라감, 실행 출력만 들어옴
$ python scripts/extract.py report.pdf
→ stdout: "표 3개 추출 완료: 매출/비용/현금흐름"
   (extract.py 200줄의 소스 코드는 컨텍스트에 적재되지 않음)

# 로컬 stdio — 같은 머신에서 서버를 자식 프로세스로 실행
claude mcp add weather -- python /path/to/weather_server.py

# 원격 Streamable HTTP — 호스팅된 엔드포인트에 연결
claude mcp add --transport http weather https://mcp.example.com/mcp

claude mcp list
claude mcp get weather
# transport, command/url, scope가 의도대로인지 확인

# 로컬 서버를 직접 띄워 검사
npx @modelcontextprotocol/inspector python /path/to/weather_server.py

# 확인 포인트
#  - initialize 응답의 protocolVersion / capabilities
#  - tools/list 에 의도한 도구가 모두 나오는지
#  - tools/call 결과(content)가 기대대로인지
# 문제 시 로그: ~/Library/Logs/Claude/mcp*.log