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

BetterBugs

The BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS C

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K

Sentry

modelcontextprotocol

Model Context Protocol Servers

88.1K

Huoshan Test

volcengine

2.4K

Altronis

sypherin

MCP server + CLI for Altronis — Singapore AI consulting. Ask the Lyra consultant, generate a grant-matched AI transformation plan, pull curated SG AI events/news. Read-only, wraps altronis.sg.