Skip to main content
Glama
Sign In
deenesjakoruzh

TODO MCP Server

by oseni99
GitHub
Python
  • Linux
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue
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 и сервер

В этом репозитории содержится минимальная реализация протокола контекста модели (MCP) для приложения списка дел, включая:

  • Сервер FastAPI ( server/ ): предоставляет конечную точку /tools для обнаружения инструментов и конечную точку /rpc для вызовов JSON-RPC для выполнения операций над задачами.
  • CLI-клиент ( client/cli.py ): интерфейс командной строки Python, который взаимодействует с LLM (через OpenAI) и сервером MCP для создания, перечисления и выполнения задач с помощью вызовов функций.

Функции

  • Добавьте задачи с названием, содержанием и, по желанию, датой выполнения.
  • Список всех задач
  • Отметить задачи как выполненные
  • Генерация идентификатора задачи на стороне сервера
  • Соответствие JSON-RPC 2.0 для вызова инструмента

Предпосылки

  • Питон 3.10+
  • pipenv или venv для виртуальных сред
  • API-ключ OpenAI

Установка

  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
  • Посетите http://127.0.0.1:8000/docs для получения интерактивной документации по API.

Запуск 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

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

Минимальная реализация сервера Model Context Protocol, предоставляющая инструменты для управления списком дел, позволяющая пользователям создавать задачи, перечислять их и отмечать как выполненные с помощью вызовов JSON-RPC.

  1. Функции
    1. Предпосылки
      1. Установка
        1. Структура каталога
          1. Запуск сервера
            1. Запуск CLI

              Related MCP Servers

              • Todo List MCP Server

                RegiByte
                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

              • Nash MCP Server

                nash-app
                -
                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

              • Task Manager MCP Server

                tradesdontlie
                -
                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

              • MCP Declarative Server

                johnhenry
                -
                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

              New MCP Servers

              ID: 01t39tz0p2