TODO MCP-Server

TODO MCP CLI & Server

Dieses Repository enthält eine minimale Model Context Protocol (MCP)-Implementierung für eine Aufgabenlistenanwendung, einschließlich:

FastAPI-Server ( server/ ): stellt einen /tools -Endpunkt für die Toolerkennung und einen /rpc -Endpunkt für JSON-RPC-Aufrufe bereit, um Vorgänge für Aufgaben auszuführen.
CLI-Client ( client/cli.py ): eine Python-Befehlszeilenschnittstelle, die mit einem LLM (über OpenAI) und dem MCP-Server interagiert, um Aufgaben mithilfe von Funktionsaufrufen zu erstellen, aufzulisten und abzuschließen.

Merkmale

Aufgaben mit Titel, Inhalt und optionalem Fälligkeitsdatum hinzufügen
Alle Aufgaben auflisten
Aufgaben als erledigt markieren
Serverseitige Task-ID-Generierung
JSON-RPC 2.0-Konformität für Toolaufrufe

Voraussetzungen

Python 3.10+
pipenv oder venv für virtuelle Umgebungen
Ein OpenAI-API-Schlüssel

Installation

Klonen Sie das Repo:
git clone https://github.com/oseni99/todo-mcp cd todo-mcp
Erstellen und aktivieren Sie eine virtuelle Umgebung:
python3 -m venv .venv source .venv/bin/activate
Installieren Sie Abhängigkeiten:
pip install -r requirements.txt
Erstellen Sie eine .env im Projektstamm:
OPENAI_API_KEY=sk-... MCP_SERVER=http://127.0.0.1:8000

Verzeichnisstruktur

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

Ausführen des Servers

fastapi dev server/main.py

Besuchen Sie http://127.0.0.1:8000/docs für interaktive API-Dokumente.

Ausführen der CLI

Vom Projektstamm:

python -m client.cli

Geben Sie an der Eingabeaufforderung Befehle in natürlicher Sprache ein, zum Beispiel:

> 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

Die CLI druckt Toolaufrufe und LLM-Antworten.