mcp-todo-server

MCP(Model Context Protocol) 기본 서버로, 할 일 목록(to-do list)을 노출하며 TypeScript와 공식 SDK @modelcontextprotocol/sdk로 구현되었습니다.

추가 과제 1 — 프로그래밍 IV — Model Context Protocol.

노출된 기능

Related MCP server: MCP Todo Server

프로젝트 구조

mcp-todo-server/
├── src/
│   └── server.ts       # Servidor MCP principal
├── tasks.json           # Almacenamiento de tareas (base de datos simple)
├── tsconfig.json        # Configuración de TypeScript
├── package.json
└── README.md

요구 사항

• Node.js 18 이상

• npm

설치

npm install

이렇게 하면 의존성이 설치됩니다: @modelcontextprotocol/sdk, zod(스키마 검증), 그리고 개발 의존성으로 typescript, @types/node, tsx.

실행

개발 모드 (TypeScript를 컴파일 없이 직접 실행):

npm run dev

프로덕션 모드 (JavaScript로 컴파일한 후 실행):

npm run build
npm start

서버는 stdio(표준 입력/출력)로 통신하며, 이는 Claude Desktop 및 대부분의 로컬 MCP 클라이언트가 사용하는 전송 방식입니다. 올바르게 시작되면 터미널에 다음이 표시됩니다:

Servidor MCP 'mcp-todo-server' corriendo por stdio...

이 메시지는 stdout으로 가는 JSON-RPC 메시지와 간섭하지 않도록 의도적으로 stderr로 출력됩니다.

그래픽 클라이언트 없이 테스트하는 방법

공식 MCP Inspector를 사용할 수 있습니다. 이는 Resources, Tools, Prompts를 수동으로 호출할 수 있는 웹 인터페이스를 엽니다:

npx @modelcontextprotocol/inspector npx tsx src/server.ts

각 기능 사용 예시

작업 resource 읽기 → tasks.json의 tasks 배열을 JSON 형식으로 반환합니다.

add_task 도구, 인자:

{ "name": "Repasar JSON-RPC", "description": "Leer la especificación 2.0", "priority": "media" }

complete_task 도구, 인자:

{ "id": 1 }

daily_summary 프롬프트는 인자를 받지 않습니다. 대기 중 및 완료된 작업을 우선순위별로 그룹화하여 자동으로 요약을 구성합니다.

저자

Camila — 코스타리카 국립대학교, 프로그래밍 IV.