TODO MCP サーバー

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またはvenv
OpenAI 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 応答を出力します。