Skip to main content
Glama
TODO MCP Server

TODO MCP Server

by oseni99

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キー


インストール

  1. リポジトリをクローンします:

    git clone https://github.com/oseni99/todo-mcp
    cd todo-mcp
  2. 仮想環境を作成してアクティブ化します。

    python3 -m venv .venv
    source .venv/bin/activate
  3. 依存関係をインストールします:

    pip install -r requirements.txt
  4. プロジェクト ルートに.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 応答を出力します。


Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers