MCP Notepad Server

# MCP 메모장 서버 - 학습용 예제 MCP(Model Context Protocol)의 핵심 기능을 학습하기 위한 간단한 메모장 서버입니다. ## 📚 학습 목표 이 예제를 통해 다음을 배울 수 있습니다: | 기능 | 설명 | 파일 | |------|------|------| | **Tools** | AI가 실행할 수 있는 액션 정의 | `src/tools/noteTools.ts` | | **Resources** | AI가 읽을 수 있는 데이터 제공 | `src/resources/noteResources.ts` | | **Prompts** | 재사용 가능한 프롬프트 템플릿 | `src/prompts/notePrompts.ts` | ## 🚀 빠른 시작 ### 1. 의존성 설치 ```bash cd mcp-notes-server npm install ``` ### 2. 빌드 ```bash npm run build ``` ### 3. Claude Desktop에 등록 `~/Library/Application Support/Claude/claude_desktop_config.json` 파일에 추가: ```json { "mcpServers": { "mcp-notes": { "command": "node", "args": ["/절대경로/mcp-notes-server/dist/index.js"] } } } ``` ### 4. Claude Desktop 재시작 ## 📦 제공 기능 ### Tools (도구) | 도구명 | 설명 | 입력 | |--------|------|------| | `create_note` | 새 메모 생성 | title, content, tags? | | `update_note` | 메모 수정 | id, title?, content?, tags? | | `delete_note` | 메모 삭제 | id | | `search_notes` | 메모 검색 | keyword | ### Resources (리소스) | URI | 설명 | |-----|------| | `notes://list` | 전체 메모 목록 | | `notes://note/{id}` | 특정 메모 조회 | ### Prompts (프롬프트) | 이름 | 설명 | 인자 | |------|------|------| | `summarize_note` | 메모 요약 | noteId, style? | | `extract_tags` | 태그 추출 | noteId, maxTags? | | `organize_notes` | 정리 제안 | - | ## 🗂 프로젝트 구조 ``` mcp-notes-server/ ├── src/ │ ├── index.ts # 진입점, 서버 설정 │ ├── store/ │ │ └── noteStore.ts # 인메모리 메모 저장소 │ ├── tools/ │ │ └── noteTools.ts # Tool 정의 및 핸들러 │ ├── resources/ │ │ └── noteResources.ts # Resource 정의 및 핸들러 │ └── prompts/ │ └── notePrompts.ts # Prompt 정의 및 핸들러 ├── package.json └── tsconfig.json ``` ## 💡 핵심 개념 정리 ### 1. Tool ```typescript // 정의 { name: "create_note", description: "새 메모 생성", inputSchema: { type: "object", properties: { title: { type: "string" }, content: { type: "string" } }, required: ["title", "content"] } } // 핸들러 server.setRequestHandler(CallToolRequestSchema, async (request) => { // 도구 실행 로직 }); ``` ### 2. Resource ```typescript // 정의 { uri: "notes://list", name: "메모 목록", mimeType: "application/json" } // 핸들러 server.setRequestHandler(ReadResourceRequestSchema, async (request) => { // 리소스 읽기 로직 }); ``` ### 3. Prompt ```typescript // 정의 { name: "summarize_note", description: "메모 요약", arguments: [ { name: "noteId", required: true } ] } // 핸들러 server.setRequestHandler(GetPromptRequestSchema, async (request) => { return { messages: [ { role: "user", content: { type: "text", text: "..." } } ] }; }); ``` ## 🔧 개발 팁 ### 디버깅 stderr로 로그 출력 (stdout은 MCP 통신에 사용): ```typescript console.error("[Debug] 메시지"); ``` ### 감시 모드 개발 ```bash npm run dev # tsc --watch ``` ## 📖 다음 단계 1. **파일 영속화**: `noteStore.ts`를 수정하여 JSON 파일로 저장 2. **추가 리소스**: 태그별, 날짜별 필터링 추가 3. **SSE 전송**: HTTP 기반 전송으로 변경해보기 ## 📚 참고 자료 - [MCP 공식 문서](https://modelcontextprotocol.io) - [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)