TODO MCP Server
TODO MCP CLI & サーバー
このリポジトリには、ToDo リスト アプリケーション用の最小限のモデル コンテキスト プロトコル (MCP) 実装が含まれています。これには以下が含まれます。
FastAPI サーバー(
server/): ツール検出用の/toolsエンドポイントと、タスクに対する操作を実行するための JSON-RPC 呼び出し用の/rpcエンドポイントを公開します。CLI クライアント(
client/cli.py): LLM (OpenAI 経由) および MCP サーバーと対話し、関数呼び出しを使用してタスクを作成、一覧表示、完了する Python コマンドライン インターフェイス。
特徴
タイトル、内容、およびオプションの期限を指定してタスクを追加します
すべてのタスクを一覧表示する
タスクを完了としてマークする
サーバー側タスクID生成
ツール呼び出しにおける JSON-RPC 2.0 準拠
前提条件
Python 3.10以上
仮想環境用のpipenvまたは
venvOpenAI APIキー
インストール
リポジトリをクローンします:
git clone https://github.com/oseni99/todo-mcp cd todo-mcp仮想環境を作成してアクティブ化します。
python3 -m venv .venv source .venv/bin/activate依存関係をインストールします:
pip install -r requirements.txtプロジェクト ルートに
.envを作成します。OPENAI_API_KEY=sk-... MCP_SERVER=http://127.0.0.1:8000
ディレクトリ構造
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サーバーの実行
fastapi dev server/main.pyインタラクティブな API ドキュメントについては、 http://127.0.0.1: 8000/docs にアクセスしてください。
CLIの実行
プロジェクトルートから:
python -m client.cliプロンプトに自然言語コマンドを入力します。例:
> 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!
> exitCLI はツールの呼び出しと LLM 応答を出力します。
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-