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
venvfür virtuelle UmgebungenEin OpenAI-API-Schlüssel
Installation
Klonen Sie das Repo:
git clone https://github.com/oseni99/todo-mcp cd todo-mcpErstellen und aktivieren Sie eine virtuelle Umgebung:
python3 -m venv .venv source .venv/bin/activateInstallieren Sie Abhängigkeiten:
pip install -r requirements.txtErstellen Sie eine
.envim 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 fileAusführen des Servers
fastapi dev server/main.pyBesuchen Sie http://127.0.0.1:8000/docs für interaktive API-Dokumente.
Ausführen der CLI
Vom Projektstamm:
python -m client.cliGeben 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!
> exitDie 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
Model Context Protocol server for todo.vu task management and time tracking.
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.31MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that provides tools for managing todo items, including creation, updating, completion, deletion, searching, and summarizing tasks.46MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server providing comprehensive task management capabilities with support for project organization, task tracking, and automatic PRD parsing into actionable items.38MIT
- -licenseAqualityNot gradedmaintenanceA task management Model Context Protocol server that helps break down user requests into manageable tasks with subtasks, dependencies, and notes, while enforcing a structured workflow with user approval steps.1725 npm10-