mcp-todo-server

# MCP Todo Server

할 일 관리를 위한 기본 MCP 서버로, 과외 과제 1(MCP)의 일부로 개발되었습니다 — 코스타리카 라티나 대학교, 프로그래밍 IV.

저자: Adonis Fabricio Fajardo Rojas

## 설명

이 서버는 Model Context Protocol을 통해 다음 기능을 제공합니다:

- **Resource** tasks://all: 전체 작업 목록을 JSON 형식으로 반환합니다.

- **Tool** add\_task(nombre, descripcion, prioridad): 새 작업을 추가합니다.

- **Tool** complete\_task(task\_id): 주어진 ID로 작업을 완료 상태로 표시합니다.

- **Prompt** daily\_summary: 작업 상태 요약 템플릿을 생성합니다.

## 요구 사항

- Python 3.10 이상

- pip

## 설치

1. 저장소를 클론합니다:

   git clone \[URL-de-tu-repo]

   cd mcp-todo-server

2. 가상 환경을 생성하고 활성화합니다:

   python -m venv venv

   venv\\Scripts\\activate

3. 의존성을 설치합니다:

   pip install -r requirements.txt

## 실행

### 개발 모드 (MCP Inspector 사용)

mcp dev server.py

이 명령은 Resources, Tools 및 Prompts를 전체 MCP 클라이언트 없이 직접 테스트할 수 있는 로컬 웹 인터페이스를 엽니다.

### Claude Desktop 연결

claude\_desktop\_config.json 파일에 다음 구성을 추가합니다:

{

  "mcpServers": {

    "todo-server": {

      "command": "python",

      "args": \["C:\\\\Users\\\\adoni\\\\mcp-todo-server\\\\server.py"]

    }

  }

}

## 프로젝트 구조

mcp-todo-server/

├── server.py # 메인 MCP 서버

├── tasks.json # 작업 저장소

├── requirements.txt # 의존성

└── README.md # 이 파일

## 호환성 참고 사항

이 프로젝트는 공식 SDK mcp==1.29.0을 사용합니다. mcp>=2.0.0으로 업그레이드하는 것은 권장되지 않습니다. 해당 버전은 호환되지 않는 변경 사항(FastMCP를 MCPServer로 이름 변경 등)을 도입하며, 이 과제 작성 시점에 Claude Desktop과의 호환성이 보장되지 않기 때문입니다.