-
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 & サーバー
このリポジトリには、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!
> exit
CLI はツールの呼び出しと LLM 応答を出力します。
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.
最小限のモデル コンテキスト プロトコル サーバー実装。ToDo リストを管理するためのツールを提供し、ユーザーがタスクを作成し、リストし、JSON-RPC 呼び出しを介してタスクを完了としてマークできるようにします。
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