fastapi_mcp README

The project's README from github.com/tadata-org/fastapi_mcp. As one markdown file: README.md.

fastapi-to-mcp

Built by Tadata

FastAPI-MCP

tadata-org%2Ffastapi_mcp | Trendshift

Expose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!

PyPI version Python Versions FastAPI CI Coverage

fastapi-mcp-usage

Features

Hosted Solution

If you prefer a managed hosted solution check out tadata.com.

Installation

We recommend using uv, a fast Python package installer:

uv add fastapi-mcp

Alternatively, you can install with pip:

pip install fastapi-mcp

Basic Usage

The simplest way to use FastAPI-MCP is to add an MCP server directly to your FastAPI application:

from fastapi import FastAPI
from fastapi_mcp import FastApiMCP

app = FastAPI()

mcp = FastApiMCP(app)

# Mount the MCP server directly to your FastAPI app
mcp.mount()

That's it! Your auto-generated MCP server is now available at https://app.base.url/mcp.

Documentation, Examples and Advanced Usage

FastAPI-MCP provides comprehensive documentation. Additionaly, check out the examples directory for code samples demonstrating these features in action.

FastAPI-first Approach

FastAPI-MCP is designed as a native extension of FastAPI, not just a converter that generates MCP tools from your API. This approach offers several key advantages:

This design philosophy ensures minimum friction when adding MCP capabilities to your existing FastAPI services.

Development and Contributing

Thank you for considering contributing to FastAPI-MCP! We encourage the community to post Issues and create Pull Requests.

Before you get started, please see our Contribution Guide.

Community

Join MCParty Slack community to connect with other MCP enthusiasts, ask questions, and share your experiences with FastAPI-MCP.

Requirements

License

MIT License. Copyright (c) 2025 Tadata Inc.

fastapi_mcp (tadata-org/fastapi_mcp)

Searching Database…

Что это такое?FastAPI-MCP превращает ваши существующие эндпоинты FastAPI в инструменты Model Context Protocol (MCP), чтобы ИИ-агенты, такие как Claude или Cursor, могли напрямую обращаться к вашему API, а аутентификация уже встроена.
Это отдельный MCP-сервер или библиотека, которую я добавляю в своё приложение?Это библиотека/расширение на Python, которое вы добавляете в свою кодовую базу FastAPI, а не отдельный инструмент-конвертер. Оно задумано как нативное расширение FastAPI, а не как средство, которое просто генерирует инструменты MCP из вашей спецификации OpenAPI.
Как добавить поддержку MCP в моё приложение FastAPI?Установите пакет через uv или pip, затем добавьте MCP-сервер прямо в ваше приложение FastAPI в паре строк кода; автоматически сгенерированный MCP-сервер сразу становится доступен.
Что нужно установить перед использованием?Нужен Python 3.10+ (рекомендуется 3.12), а рекомендуемый способ установки — менеджер пакетов uv, хотя pip тоже подходит.
Оно просто конвертирует мою спецификацию OpenAPI в инструменты MCP, как другие конвертеры?Нет — оно намеренно не является «ещё одним конвертером OpenAPI -> MCP». Оно взаимодействует с вашим приложением напрямую через ASGI, а не делает HTTP-запросы, поэтому не нужен отдельный шаг конвертации или дополнительный сетевой переход.
Для кого это создано?Для разработчиков, у которых уже есть бэкенд на FastAPI и которые хотят открыть его ИИ-агентам, не создавая отдельный слой интеграции.
Как работает аутентификация для открытых инструментов MCP?FastAPI-MCP переиспользует ваши существующие функции Depends() из FastAPI, поэтому вы защищаете эндпоинты MCP точно так же, как уже защищаете свои REST-эндпоинты.
Можно ли запускать MCP-сервер отдельно от основного API?Да, развёртывание гибкое — можно подключить MCP-сервер к тому же приложению FastAPI или развернуть его отдельно, если это удобнее.
Есть ли хостируемый вариант, если я не хочу управлять им сам?Да, создатели (Tadata) предлагают управляемое решение на tadata.com для команд, которые не хотят самостоятельно запускать FastAPI-MCP.
Сохраняет ли оно мою существующую документацию API и схемы?Да, оно сохраняет схемы моделей запросов и ответов и документацию эндпоинтов точно в том виде, в каком они отображаются в Swagger.
Creator
tadata-org
Size
0.4 MB
Stars
12K
Age
1y
Commits · 90 Days