Todo App - FastAPI to MCP Conversion

This project demonstrates how to create a FastAPI todo application and convert it to an MCP (Model Context Protocol) server.

Project Structure

├── main.py              # FastAPI application
├── models.py            # Pydantic models for data validation
├── database.py          # In-memory database operations
├── mcp_server.py        # MCP server implementation
├── mcp_config.json     # MCP server configuration
├── test_mcp.py         # Test script for MCP server
├── requirements.txt    # Python dependencies
└── README.md           # This file

Features

FastAPI Application

• RESTful API endpoints for todo management

• CRUD operations (Create, Read, Update, Delete)

• Data validation with Pydantic models

• In-memory storage for simplicity

MCP Server

• Converts FastAPI functionality to MCP tools

• 5 available tools: list_todos, get_todo, create_todo, update_todo, delete_todo

• Compatible with MCP clients and AI assistants

Installation

1. Create and activate a virtual environment:

python -m venv venv
# On Windows:
.\venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

2. Install dependencies:

pip install -r requirements.txt

Usage

Running the FastAPI Application

python main.py

The API will be available at http://localhost:8000

API Endpoints:

• GET / - Welcome message

• GET /todos - List all todos

• GET /todos/{id} - Get specific todo

• POST /todos - Create new todo

• PUT /todos/{id} - Update todo

• DELETE /todos/{id} - Delete todo

Running the MCP Server

python mcp_server.py

The MCP server provides these tools:

• list_todos - Get all todos

• get_todo - Get specific todo by ID

• create_todo - Create new todo

• update_todo - Update existing todo

• delete_todo - Delete todo

Testing the MCP Server

python test_mcp.py

This will run a comprehensive test of all MCP server functionality.

API Examples

FastAPI Examples

Create a todo:

curl -X POST "http://localhost:8000/todos" \
     -H "Content-Type: application/json" \
     -d '{"title": "Learn MCP", "description": "Study Model Context Protocol", "status": "pending"}'

Get all todos:

curl "http://localhost:8000/todos"

MCP Tool Examples

The MCP server can be used with MCP-compatible clients. The tools accept JSON arguments and return structured responses.

Data Models

Todo Model

• id: Integer (auto-generated)

• title: String (required)

• description: String (optional)

• status: Enum (pending, in_progress, completed)

• created_at: DateTime (auto-generated)

• updated_at: DateTime (auto-updated)

Status Values

• pending: Todo is not started

• in_progress: Todo is being worked on

• completed: Todo is finished

Development

The project uses:

• FastAPI for the REST API

• Pydantic for data validation

• MCP for the protocol server

• asyncio for asynchronous operations

Notes

• The database is in-memory and will reset when the application restarts

• The MCP server runs in stdio mode for easy integration

• Both the FastAPI app and MCP server share the same data models and business logic

MCP-Server