Todo List MCP Server

Ein kleiner Model Context Protocol-Server, der eine einfache JSON-Datei in eine Todo-Liste verwandelt, die ein MCP-kompatibler Client (Claude Desktop, Claude Code, Cursor usw.) in deinem Namen lesen und verwalten kann.

Was er tut

Er stellt fünf Tools und eine Ressource bereit:

Die Daten liegen in todos.json neben server.py, sodass sie Neustarts überstehen.

Related MCP server: MCP Todo List

Einrichtung

# 1. Clone / copy this folder
cd todo-mcp

# 2. Create a virtual environment and install dependencies
python3 -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install -r requirements.txt

# 3. Run it directly to sanity-check it starts (Ctrl+C to stop)
python server.py

Mit einem MCP-Client verbinden

Claude Desktop

Füge dies zu deiner claude_desktop_config.json hinzu (Einstellungen → Entwickler → Konfiguration bearbeiten):

{
  "mcpServers": {
    "todo-list": {
      "command": "/absolute/path/to/todo-mcp/venv/bin/python",
      "args": ["/absolute/path/to/todo-mcp/server.py"]
    }
  }
}

Starte Claude Desktop neu, und du siehst die Todo-Tools in der Tool-Auswahl (Hammersymbol). Versuche: „Füge ‚MCP-Ticket abschließen' als Aufgabe mit hoher Priorität hinzu und zeig mir dann alles Offene."

MCP Inspector (zur lokalen Fehlersuche)

npx @modelcontextprotocol/inspector python server.py

Dies öffnet eine Browser-Oberfläche, in der du jedes Tool manuell aufrufen und die rohe JSON-RPC-Anfrage/-Antwort sehen kannst – der beste Weg, um zu verstehen, was tatsächlich zwischen Client und Server über die Leitung geht.

Auf Smithery bereitstellen

1. Verschiebe diesen Ordner in ein öffentliches GitHub-Repository (benötigt werden server.py, pyproject.toml, requirements.txt und smithery.yaml).

2. Gehe zu smithery.ai → Neuer Server → verbinde dein GitHub-Repository.

3. Smithery liest smithery.yaml, um zu erfahren, wie der Server gestartet wird (python server.py über stdio), und baut/stellet ihn automatisch bereit.

4. Nach der Bereitstellung kann jeder den Server direkt von deiner Smithery-Listungsseite zu seinem eigenen MCP-Client hinzufügen – ohne lokale Einrichtung.

Hinweise zur Funktionsweise

Erstellt mit dem offiziellen MCP Python SDK unter Verwendung von FastMCP, das einfache Python-Funktionen über den @mcp.tool()-Dekorator in MCP-Tools verwandelt – die Typannotationen und der Docstring werden automatisch zum JSON-Schema und zur Beschreibung des Tools, die das Client-Modell liest, um zu entscheiden, wann und wie jedes Tool aufgerufen wird.