Skip to main content
Glama
TODO MCP Server

TODO MCP Server

by oseni99

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

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.


Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers