MCP 서버 메타데이터 표준 스키마
모든 서버 .md 파일은 아래 구조를 준수한다.
템플릿
# {서버명}
## 메타데이터
| 항목 | 값 |
|------|---|
| **패키지명** | `@scope/server-xxx` |
| **Transport** | stdio / http |
| **카테고리** | browser / search / database / filesystem / memory / devtools / communication / cloud / monitoring / automation / utility / ai / productivity |
| **설치 방식** | `npx -y @scope/server-xxx` |
| **필수 환경변수** | `API_KEY` (또는 "없음") |
| **선택 환경변수** | `TIMEOUT`, `MAX_RESULTS` (또는 "없음") |
| **공식 문서** | URL |
| **최근 검증일** | YYYY-MM-DD |
## 설정 스니펫
\```json
{
"mcpServers": {
"xxx": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@scope/server-xxx"]
}
}
}
\```
## 제공 도구
| 도구명 | 설명 | Claude Code 호출 |
|--------|------|-----------------|
| `tool_name` | 기능 설명 | `mcp__xxx__tool_name` |
## 사용 사례
- 어떤 스킬/에이전트에서 사용하는지
- 어떤 프로젝트 타입에 적합한지
## 주의사항
- 설치 전제 조건, 알려진 이슈 등
필드 규칙
| 필드 | 필수 | 규칙 |
|---|---|---|
| 서버명 | O | 영문 소문자, 공식 이름 사용 |
| 패키지명 | O | npm 또는 pip 패키지명 |
| Transport | O | stdio 또는 http |
| 카테고리 | O | 11개 카테고리 중 택 1 |
| 설치 방식 | O | 실행 가능한 명령어 |
| 필수 환경변수 | O | 없으면 "없음" 명시 |
| 선택 환경변수 | O | 없으면 "없음" 명시 |
| 공식 문서 | O | 유효한 URL |
| 최근 검증일 | O | 마지막으로 설정 테스트한 날짜 |
| 설정 스니펫 | O | .mcp.json에 복붙 가능한 JSON |
| 제공 도구 | O | 최소 주요 도구 나열 |
| 사용 사례 | O | 1개 이상 |
| 주의사항 | △ | 특이사항 있을 때만 |
환경변수 표기
- 필수: 반드시 설정해야 서버 동작
- 선택: 미설정 시 기본값 사용
- 스니펫 내 환경변수는
${VAR}형식 사용 (Claude Code 자동 확장)