MCP.so
Sign In

Description

@KimiJL

Repository

About Description

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

#python#mcp#fastapi#mcp-server

Basic information

Category

Developer Tools

License

MIT license

Runtime

python

Transports

stdio

Publisher

KimiJL

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

Comments

More Developer Tools MCP servers

MCP-Scan: An MCP Security Scanner

invariantlabs-ai

Security scanner for AI agents, MCP servers and agent skills.

2.8K

JetBrains MCP Proxy Server

JetBrains

A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio

962

Golf

golf-mcp

Production-Ready MCP Server Framework • Build, deploy & scale secure AI agent infrastructure • Includes Auth, Observability, Debugger, Telemetry & Runtime • Run real-world MCPs powering AI Agents

834

Serena

oraios

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

26.2K

OpenSumi

opensumi

A framework helps you quickly build AI Native IDE products. MCP Client, supports Model Context Protocol (MCP) tools via MCP server.

3.6K