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

1. Klonen Sie das Repo:

   git clone https://github.com/oseni99/todo-mcp
   cd todo-mcp

2. Erstellen und aktivieren Sie eine virtuelle Umgebung:

   python3 -m venv .venv
   source .venv/bin/activate

3. Installieren Sie Abhängigkeiten:

   pip install -r requirements.txt

4. 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.