TODO MCP Server

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

Установка

1. Клонируйте репозиторий:
   git clone https://github.com/oseni99/todo-mcp cd todo-mcp
2. Создайте и активируйте виртуальную среду:
   python3 -m venv .venv source .venv/bin/activate
3. Установите зависимости:
   pip install -r requirements.txt
4. Создайте .env в корне проекта:
   OPENAI_API_KEY=sk-... MCP_SERVER=http://127.0.0.1:8000

Структура каталога

Запуск сервера

• Посетите http://127.0.0.1:8000/docs для получения интерактивной документации по API.

Запуск CLI

Из корня проекта:

Введите в командной строке команды на естественном языке, например:

CLI выведет вызовы инструментов и ответы LLM.