-
securityA
license-
qualityA Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.
Last updated -
26
MIT License
TODO MCP CLI и сервер
В этом репозитории содержится минимальная реализация протокола контекста модели (MCP) для приложения списка дел, включая:
Сервер FastAPI (
server/): предоставляет конечную точку/toolsдля обнаружения инструментов и конечную точку/rpcдля вызовов JSON-RPC для выполнения операций над задачами.CLI-клиент (
client/cli.py): интерфейс командной строки Python, который взаимодействует с LLM (через OpenAI) и сервером MCP для создания, перечисления и выполнения задач с помощью вызовов функций.
Функции
Добавьте задачи с названием, содержанием и, по желанию, датой выполнения.
Список всех задач
Отметить задачи как выполненные
Генерация идентификатора задачи на стороне сервера
Соответствие JSON-RPC 2.0 для вызова инструмента
Предпосылки
Питон 3.10+
pipenv или
venvдля виртуальных средAPI-ключ OpenAI
Установка
Клонируйте репозиторий:
git clone https://github.com/oseni99/todo-mcp cd todo-mcpСоздайте и активируйте виртуальную среду:
python3 -m venv .venv source .venv/bin/activateУстановите зависимости:
pip install -r requirements.txtСоздайте
.envв корне проекта:OPENAI_API_KEY=sk-... MCP_SERVER=http://127.0.0.1:8000
Структура каталога
todoMCP/
├── client/ # CLI client code
│ └── cli.py # Main entrypoint for the MCP-CLI
├── server/ # FastAPI server code
│ ├── handlers.py # Business logic for add, list, complete
│ ├── tools.py # JSON-Schema tool manifest
│ └── main.py # FastAPI app with /tools and /rpc
├── .env # Environment variables (not committed)
├── requirements.txt # Python dependencies
└── README.md # This file
Запуск сервера
fastapi dev server/main.py
Посетите http://127.0.0.1:8000/docs для получения интерактивной документации по API.
Запуск CLI
Из корня проекта:
python -m client.cli
Введите в командной строке команды на естественном языке, например:
> Create a task titled "Write blog post" with content "Outline first draft" due 2025-05-20
> List my tasks
> Mark the first task as done
> Thanks!
> exit
CLI выведет вызовы инструментов и ответы LLM.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Минимальная реализация сервера Model Context Protocol, предоставляющая инструменты для управления списком дел, позволяющая пользователям создавать задачи, перечислять их и отмечать как выполненные с помощью вызовов JSON-RPC.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server that provides tools for managing todo items, including creation, updating, completion, deletion, searching, and summarizing tasks.Last updated -31MIT License
- -securityAlicense-qualityA Model Context Protocol server providing comprehensive task management capabilities with support for project organization, task tracking, and automatic PRD parsing into actionable items.Last updated -26MIT License
- AsecurityAlicenseAqualityA task management Model Context Protocol server that helps break down user requests into manageable tasks with subtasks, dependencies, and notes, while enforcing a structured workflow with user approval steps.Last updated -178410MIT License