Description

Name: Description
Author: KimiJL

@KimiJL

代码仓库

关于 Description

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

#python #mcp #fastapi #mcp-server

基本信息

分类

开发工具

许可证

MIT license

运行时

python

传输方式

stdio

发布者

KimiJL

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.