mcp-builderlisted
Install: claude install-skill This-HW/claude-code-kit
# MCP Server Builder
> Model Context Protocol 서버 개발 및 구성
MCP 서버를 생성하고 Claude Code에 통합합니다.
---
## 사용법
### 신규 MCP 서버 생성
```
/mcp-builder "파일 시스템 접근" filesystem
/mcp-builder "데이터베이스 조회" database-query
/mcp-builder "API 통합" external-api
```
### 기존 MCP 서버 설정
```
/mcp-builder setup postgres
/mcp-builder configure playwright
```
---
## MCP 서버 유형
### 1. Tools 서버
외부 도구 및 API 접근:
- 데이터베이스 쿼리
- 파일 시스템 조작
- 외부 API 호출
- 시스템 명령 실행
### 2. Resources 서버
정적 리소스 제공:
- 문서 검색
- 설정 파일 읽기
- 템플릿 제공
### 3. Prompts 서버
사전 정의된 프롬프트:
- 재사용 가능한 질의
- 템플릿 프롬프트
---
## 개발 워크플로우
### 1. 프로젝트 초기화
```bash
# Python MCP 서버
mkdir mcp-server-myproject
cd mcp-server-myproject
python -m venv venv
source venv/bin/activate
pip install mcp
```
### 2. 서버 구조 생성
```
mcp-server-myproject/
├── src/
│ ├── __init__.py
│ └── server.py # MCP 서버 구현
├── pyproject.toml # 의존성
└── README.md # 사용법
```
### 3. Tools 정의
```python
from mcp import Server, Tool
server = Server("myproject-server")
@server.tool()
async def my_tool(arg1: str, arg2: int) -> str:
"""도구 설명"""
# 구현
return result
```
### 4. 서버 실행
```python
if __name__ == "__main__":
server.run()
```
---
## Claude Code 통합
### 1. MCP 설정 파일 수정
`~/.claude/settings.json`:
```json
{
"mcpServers": {
"myproject": {
"command": "python",
"args": ["-m", "mcp_server_myproject"],
"env": {
"API_KEY": "your-key"
}
}
}
}
```
### 2. 서버 시작
```bash
claude mcp list