📝 Personal To-Do List MCP Server

AI 어시스턴트에게 강력한 로컬 할 일 목록 관리자를 제공하는 미니멀하면서도 실용적인 Model Context Protocol (MCP) 서버입니다. 이 서버는 외부 API나 복잡한 데이터베이스 없이도 AI가 로컬 상태를 관리하고 영구 데이터(CRUD 작업)와 상호작용하는 방법을 보여줍니다.

🌐 라이브 데모 및 미디어

• 라이브 레지스트리 목록: Glama MCP Server

Related MCP server: Todo MCP Server

📸 스크린샷

✨ 주요 기능

• 🤖 네이티브 AI 통합: Claude Desktop, Cursor, Antigravity와 완벽하게 연동됩니다.

• 🛠️ 완전한 CRUD 작업: 작업 추가, 목록 보기, 완료, 삭제가 가능합니다.

• 📊 실시간 요약: 대기 중인 작업과 완료된 작업을 요약하는 읽기 전용 리소스를 제공합니다.

• 🔒 프라이빗 로컬 저장소: JSON을 사용하여 데이터를 전적으로 로컬 머신에 저장합니다.

• ⚙️ 제로 구성: 최신 Python 패키징으로 별도 설정 없이 바로 작동합니다.

🛠️ 기술 스택 표

⚙️ 작동 방식

1. 도구 호출: AI 클라이언트가 MCP 서버에 JSON-RPC 요청을 보냅니다 (예: add_task).

2. 실행: Python 서버가 로컬 todos.json 파일을 파싱합니다.

3. 수정: 서버가 새 작업으로 JSON 파일을 업데이트하고 저장합니다.

4. 응답: 서버가 AI 클라이언트에 성공 확인을 반환합니다.

🏗️ 프로젝트 아키텍처

graph LR
    A[AI Assistant] <-->|JSON-RPC via stdio| B[Todo MCP Server]
    B -->|Read/Write| C[(todos.json)]
    B --> D[Tools: add, list, delete, complete]
    B --> E[Resources: todo://summary]

📂 프로젝트 구조

├── docs/                      # Learning outcomes and documentation
│   ├── inspector.png
│   └── resend-experience.md
├── src/
│   └── todo_mcp/              # Core MCP server package
│       ├── __init__.py
│       ├── __main__.py        # Execution entrypoint
│       └── server.py          # Tools and resources logic
├── .gitignore
├── pyproject.toml             # Modern Python package configuration
└── README.md

💻 로컬 설정 및 설치

사전 요구 사항

• Python 3.10 이상

• Node.js (Inspector 사용 시 npx 용)

설치

저장소를 클론하고 pip를 사용하여 로컬에 설치합니다:

git clone https://github.com/Arslan-Codes097/todo-list-mcp-server.git
cd todo-list-mcp-server
pip install .

로컬 실행 (Inspector)

대화형 MCP Inspector UI에서 도구를 테스트하려면:

npx @modelcontextprotocol/inspector python -m todo_mcp

AI 클라이언트에 연결 (무설치)

이 서버를 사용하는 가장 쉬운 방법은 uvx를 이용하는 것입니다. 저장소를 수동으로 클론할 필요 없이 서버를 자동으로 다운로드하고 실행합니다.

클라이언트의 config.json에 다음을 추가하세요:

{
  "mcpServers": {
    "todo-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Arslan-Codes097/todo-list-mcp-server.git",
        "python",
        "-m",
        "todo_mcp"
      ]
    }
  }
}

👤 작성자 및 크레딧

Arslan

• GitHub: @Arslan-Codes097

Model Context Protocol에 대한 실습 탐구로 제작되었습니다.