-
securityA
license-
qualityA 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.
Last updated -
26
MIT License
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 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.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Eine minimale Serverimplementierung des Model Context Protocol, die Tools zum Verwalten einer Aufgabenliste bereitstellt und es Benutzern ermöglicht, Aufgaben zu erstellen, aufzulisten und über JSON-RPC-Aufrufe als erledigt zu markieren.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server that provides tools for managing todo items, including creation, updating, completion, deletion, searching, and summarizing tasks.Last updated -31MIT License
- -securityAlicense-qualityA Model Context Protocol server providing comprehensive task management capabilities with support for project organization, task tracking, and automatic PRD parsing into actionable items.Last updated -26MIT License
- AsecurityAlicenseAqualityA 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.Last updated -178410MIT License