Description

@KimiJL

About Description

Example web app mounting a model context protocol (MCP) server on a FastAPI server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "fastapi-mcp": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "fastapi-mcp",
        "."
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Description?

Description is a simple example web app and client that demonstrates mounting a Model Context Protocol (MCP) server onto an existing FastAPI server. It is intended for developers learning how to integrate MCP with FastAPI.

How to use Description?

Build and run the server using Docker (docker build -t fastapi-mcp . then docker run -p 8000:8000 --net=host fastapi-mcp) or set up a Python environment, install dependencies, and run uvicorn src.main:app. Then execute the sample client with python client/client.py.

Key features of Description?

Mounts an MCP server onto existing FastAPI
Includes sample client using MCP client library
Uses MCP Python SDK for server logic
Containerized with Docker for easy deployment
Modular code with separate server and client modules

Use cases of Description?

Learning how to integrate MCP with a FastAPI application
Testing MCP server functionality via a sample client
Prototyping MCP-based services with minimal setup
Understanding FastAPI sub‑application mounting patterns

FAQ from Description

What is the purpose of this project?

It serves as a learning example showing how to mount a Model Context Protocol server on top of a FastAPI application, with a matching client that communicates using the MCP client library.

What are the runtime requirements?

The server can run inside Docker or directly with Python. The client requires the packages listed in requirements.txt.

Where is the MCP server mounted?

The MCP server is mounted as a sub‑application on the FastAPI server, currently limited to the root path / due to a known issue in the MCP Python SDK.

How do I run the

Frequently asked questions

What is the purpose of this project?

It serves as a learning example showing how to mount a Model Context Protocol server on top of a FastAPI application, with a matching client that communicates using the MCP client library.

What are the runtime requirements?

The server can run inside Docker or directly with Python. The client requires the packages listed in `requirements.txt`.

Where is the MCP server mounted?

The MCP server is mounted as a sub‑application on the FastAPI server, currently limited to the root path `/` due to a known issue in the MCP Python SDK.

Comments

Basic information

More Developer Tools MCP servers

MCP Server By TestMu AI

TestMu AI

TestMu AI MCP Server lets developers run, debug, and triage tests through natural language directly from their IDE (Cursor, Claude, GitHub Copilot, and other MCP clients). It exposes five tools — HyperExecute (test orche

Serena

oraios

A powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent

26.2K

MCP Inspector

modelcontextprotocol

Visual testing tool for MCP servers

10.3K

TalkToFigma

sonnylazuardi

TalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

6.9K

endoflife.ai

Free MCP server for software end-of-life intelligence: EOL dates, support status, and the 0-100 EOL Risk Score across 480+ tracked products. Agents can check a single version, pull a product's full lifecycle schedule, or