FastAPI

FastAPI-MCP преобразует эндпоинты FastAPI в инструменты Model Context Protocol (MCP) без настройки. Интегрируйте с LLM, такими как Claude и Cursor. Начните работу быстро!

Избранные Разработка API Инструменты разработчика Прочее ★ 275 GitHub (275 ★)

FastAPI-MCP упрощает интеграцию приложений FastAPI со средами Model Context Protocol (MCP). Он автоматически преобразует конечные точки FastAPI в инструменты MCP, устраняя необходимость ручной настройки. Это позволяет разработчикам легко подключать свои API к LLM-рабочим процессам и инструментам, таким как Cursor и Claude, сохраняя существующие схемы и документацию. Для повышения гибкости также можно добавлять пользовательские инструменты вместе с автоматически сгенерированными.

Ключевые особенности

01Сохраняет схемы моделей запросов и ответов.

02Напрямую интегрирует MCP-сервер в приложение FastAPI.

03Автоматически обнаруживает и преобразует конечные точки FastAPI в инструменты MCP.

04275 звезд на GitHub

05Не требует настройки для базового использования.

06Сохраняет документацию конечных точек из Swagger.

Варианты использования

01Подключение API на базе FastAPI к Cursor для AI-ассистированной разработки.

02Интеграция сервисов FastAPI с Claude Desktop через mcp-proxy.

03Предоставление существующих приложений FastAPI в качестве набора инструментов для LLM.

FastAPI-MCP

A zero-configuration tool for automatically exposing FastAPI endpoints as Model Context Protocol (MCP) tools.

Features

Direct integration - Mount an MCP server directly to your FastAPI app
Zero configuration required - just point it at your FastAPI app and it works
Automatic discovery of all FastAPI endpoints and conversion to MCP tools
Preserving schemas of your request models and response models
Preserve documentation of all your endpoints, just as it is in Swagger
Extend - Add custom MCP tools alongside the auto-generated ones

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 add_mcp_server

# Your FastAPI app
app = FastAPI()

# Mount the MCP server to your app
add_mcp_server(
    app,                    # Your FastAPI app
    mount_path="/mcp",      # Where to mount the MCP server
    name="My API MCP",      # Name for the MCP server
)

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

Advanced Usage

FastAPI-MCP provides several ways to customize and control how your MCP server is created and configured. Here are some advanced usage patterns:

from fastapi import FastAPI
from fastapi_mcp import add_mcp_server

app = FastAPI()

mcp_server = add_mcp_server(
    app,                                    # Your FastAPI app
    mount_path="/mcp",                      # Where to mount the MCP server
    name="My API MCP",                      # Name for the MCP server
    describe_all_responses=True,            # False by default. Include all possible response schemas in tool descriptions, instead of just the successful response.
    describe_full_response_schema=True      # False by default. Include full JSON schema in tool descriptions, instead of just an LLM-friendly response example.
)

# Optionally add custom tools in addition to existing APIs.
@mcp_server.tool()
async def get_server_time() -> str:
    """Get the current server time."""
    from datetime import datetime
    return datetime.now().isoformat()

Examples

See the examples directory for complete examples.

Connecting to the MCP Server using SSE

Once your FastAPI app with MCP integration is running, you can connect to it with any MCP client supporting SSE, such as Cursor:

Run your application.
In Cursor -> Settings -> MCP, use the URL of your MCP server endpoint (e.g., http://localhost:8000/mcp) as sse.
Cursor will discover all available tools and resources automatically.

Connecting to the MCP Server using mcp-proxy stdio

If your MCP client does not support SSE, for example Claude Desktop:

Run your application.
Install mcp-proxy, for example: uv tool install mcp-proxy.
Add in Claude Desktop MCP config file (claude_desktop_config.json):

On Windows:

{
  "mcpServers": {
    "my-api-mcp-proxy": {
        "command": "mcp-proxy",
        "args": ["http://127.0.0.1:8000/mcp"]
    }
  }
}

On MacOS:

{
  "mcpServers": {
    "my-api-mcp-proxy": {
        "command": "/Full/Path/To/Your/Executable/mcp-proxy",
        "args": ["http://127.0.0.1:8000/mcp"]
    }
  }
}

Find the path to mcp-proxy by running in Terminal: which mcp-proxy.

Claude Desktop will discover all available tools and resources automatically

Development and Contributing

Thank you for considering contributing to FastAPI-MCP open source projects! It’s people like you that make it a reality for users in our community.

Before you get started, please see CONTRIBUTING.md.

Community

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

Requirements

Python 3.10+
uv

License

About

Developed and maintained by Tadata Inc.

FastAPI-MCP

Автоматическое преобразование эндпоинтов FastAPI в инструменты Model Context Protocol (MCP) без какой-либо конфигурации.

Репозиторий: github.com/tadata-org/fastapi_mcp PyPI: pypi.org/project/fastapi-mcp

Возможности

Прямая интеграция: MCP-сервер монтируется прямо в ваше FastAPI-приложение.
Ноль конфигурации: просто укажите приложение.
Автоматическое обнаружение всех эндпоинтов FastAPI и их преобразование в MCP-инструменты.
Сохранение схем запросов и ответов.
Документация эндпоинтов сохраняется так же, как в Swagger.
Расширяемость: можно добавлять собственные MCP-инструменты рядом с автоматически сгенерированными.

Установка

Рекомендуется использовать uv — быстрый установщик Python-пакетов:

uv add fastapi-mcp

Или через pip:

pip install fastapi-mcp

Быстрый старт

Просто добавьте MCP-сервер к вашему FastAPI-приложению:

from fastapi import FastAPI
from fastapi_mcp import add_mcp_server

app = FastAPI()

add_mcp_server(
    app,
    mount_path="/mcp",
    name="My API MCP"
)

Готово! MCP-сервер доступен по адресу https://app.base.url/mcp.

Продвинутое использование

Вы можете настроить поведение MCP-сервера с помощью дополнительных параметров:

from fastapi import FastAPI
from fastapi_mcp import add_mcp_server

app = FastAPI()

mcp_server = add_mcp_server(
    app,
    mount_path="/mcp",
    name="My API MCP",
    describe_all_responses=True,        # Включает все возможные схемы ответов в описание инструмента
    describe_full_response_schema=True  # Включает полную JSON-схему вместо упрощённого примера
)

# Добавление собственного MCP-инструмента
@mcp_server.tool()
async def get_server_time() -> str:
    """Возвращает текущее время сервера."""
    from datetime import datetime
    return datetime.now().isoformat()

Подключение к MCP-серверу

Через SSE

Подходит для клиентов, поддерживающих SSE (например, Cursor):

Запустите ваше приложение.
В Cursor → Settings → MCP укажите URL эндпоинта MCP-сервера (например, http://localhost:8000/mcp) как sse.
Cursor автоматически обнаружит все доступные инструменты.

Через mcp-proxy (stdio)

Если клиент не поддерживает SSE (например, Claude Desktop):

Запустите приложение.
Установите mcp-proxy: uv tool install mcp-proxy.

Добавьте в конфиг Claude Desktop (claude_desktop_config.json):

Windows:

{
  "mcpServers": {
    "my-api-mcp-proxy": {
      "command": "mcp-proxy",
      "args": ["http://127.0.0.1:8000/mcp"]
    }
  }
}

macOS:

{
  "mcpServers": {
    "my-api-mcp-proxy": {
      "command": "/Full/Path/To/Your/Executable/mcp-proxy",
      "args": ["http://127.0.0.1:8000/mcp"]
    }
  }
}

Путь к mcp-proxy можно узнать командой which mcp-proxy в терминале.

Claude Desktop автоматически обнаружит инструменты.

Примеры

Полные примеры смотрите в директории examples.

Системные требования

Python 3.10+
uv (рекомендуется) или pip

Разработка и вклад

См. CONTRIBUTING.md. Присоединяйтесь к MCParty Slack для общения.

Лицензия

Источник: https://mcpmarket.com/server/fastapi

FastAPI

Ключевые особенности

Варианты использования

FastAPI-MCP

Features

Installation

Basic Usage

Advanced Usage

Examples

Connecting to the MCP Server using SSE

Connecting to the MCP Server using mcp-proxy stdio

Development and Contributing

Community

Requirements

License

About

FastAPI-MCP

Возможности

Установка

Быстрый старт

Продвинутое использование

Подключение к MCP-серверу

Через SSE

Через mcp-proxy (stdio)

Примеры

Системные требования

Разработка и вклад

Лицензия

Что такое FastAPI-MCP?

С какими инструментами LLM можно интегрировать FastAPI-MCP?

Каковы преимущества использования FastAPI-MCP?

Насколько легко настроить FastAPI-MCP?

Что если мой LLM-клиент не поддерживает SSE?

Комментарии