TODO MCP Server

by oseni99
  • Linux
  • Apple
Integrations
  • Manages environment variables for the application, including the OpenAI API key and MCP server URL configuration.

  • Provides the server framework for the MCP implementation, exposing endpoints for tool discovery and JSON-RPC calls to interact with the to-do list application.

  • Provides version control for the MCP implementation, with instructions for cloning the repository during installation.

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


-
security - not tested
F
license - not found
-
quality - not tested

最小限のモデル コンテキスト プロトコル サーバー実装。ToDo リストを管理するためのツールを提供し、ユーザーがタスクを作成し、リストし、JSON-RPC 呼び出しを介してタスクを完了としてマークできるようにします。

  1. 特徴
    1. 前提条件
      1. インストール
        1. ディレクトリ構造
          1. サーバーの実行
            1. CLIの実行

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                A Model Context Protocol (MCP) server that provides tools for managing todo items, including creation, updating, completion, deletion, searching, and summarizing tasks.
                Last updated -
                10
                4
                TypeScript
                MIT License
              • -
                security
                A
                license
                -
                quality
                A Model Context Protocol server that enables seamless execution of commands, Python code, web content fetching, and reusable task management with secure credentials handling.
                Last updated -
                2
                Python
                MIT License
                • Apple
              • -
                security
                A
                license
                -
                quality
                A 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 -
                4
                Python
                MIT License
                • Linux
                • Apple
              • -
                security
                F
                license
                -
                quality
                A utility module for creating Model Context Protocol servers declaratively, allowing developers to easily define tools, prompts, and resources with a simplified syntax.
                Last updated -
                JavaScript

              View all related MCP servers

              ID: 01t39tz0p2