mcpField
T
Todo App with MCP Server

Todo App with MCP Server

Local
github.com/sam55silverProductivity0Updated 80w ago
Repository

About Todo App with MCP Server

A demo Todo application with a FastAPI backend and MCP server, for connecting AI assistants to Todo operations. It includes a React/TypeScript frontend and documents Claude Desktop setup.

Key features

  1. 01React/TypeScript Todo frontend
  2. 02FastAPI Todo backend
  3. 03Tool-based Todo interaction
  4. 04Claude Desktop setup guide

Use cases

  1. 01Connect Claude Desktop to Todo operations
  2. 02Try an MCP-backed Todo application

MCP support

The MCP server exposes tool-based interaction with the Todo application to MCP clients, including Claude Desktop.

#todo#mcp#ai-assistant

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Todo App with MCP Server

Project Overview

This project demonstrates how to build a Model Context Protocol (MCP) server that interacts with a simple Todo application. It consists of three main components:

  1. Client: A React/TypeScript frontend application
  2. Server: A FastAPI backend that manages Todo items
  3. MCP Server: A specialized server that provides tool-based interaction with the Todo application

What is MCP (Model Context Protocol)?

The Model Context Protocol (MCP) is an open standard developed by Anthropic that enables AI systems to dynamically connect with external tools, files, and APIs. It provides a standardized way for AI models to access real-time data and execute operations through defined tools.

MCP uses a client-server architecture:

  • MCP Server: Provides structured access to data and functionality (like our Todo API)
  • MCP Client: The AI application that requests context or actions from the MCP Server

Think of MCP as a "USB-C for AI connectivity" - a universal interface that allows AI systems to seamlessly integrate with external data sources and tools without requiring custom integration for each new system.

Getting Started

Prerequisites
  • Docker and Docker Compose
  • NodeJS
  • Python
  • UV (Python package manager)
  • Claude Desktop (for using with Anthropic's Claude AI)
Starting the Application
  1. Clone this repository
  2. Run Docker Compose to start all services:
docker-compose up

This will start the following services:

Using with Claude Desktop

To use the MCP server with Claude Desktop:

  1. Locate your Claude Desktop configuration file:
    • macOS: ~/Library/Application Support/Claude Desktop/claude_desktop_config.json
    • Windows: %APPDATA%\Claude Desktop\claude_desktop_config.json
    • Linux: ~/.config/Claude Desktop/claude_desktop_config.json
  2. Add the todo-mcp server to the configuration by adding or updating the mcpServers section:
{
  "mcpServers": {
    "todo-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/repo/todo-mcp",
        "run",
        "main.py"
      ]
    }
  }
}
  1. Replace /path/to/repo/todo-mcp with the actual path to your todo-mcp directory
  2. Save the file and restart Claude Desktop
  3. When using Claude, you can now access the todo-mcp server and its tools through the Claude interface

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.