FastAPI MCP

FastAPI MCP

FastAPI-MCP é uma poderosa extensão para FastAPI que permite expor facilmente os endpoints da sua aplicação FastAPI como ferramentas Model Context Protocol (MCP). Ele possibilita uma integração segura entre as APIs do FastAPI e agentes ou fluxos de trabalho alimentados por LLM, transformando os endpoints existentes em ferramentas MCP com uma configuração mínima. Oferece autenticação nativa do MCP, preservação de esquema e documentação nativa, tudo isso aproveitando suas dependências e infraestrutura de implantação existentes no FastAPI.

Author: tadata-org


Ver Protocolo

O que é FastAPI-MCP?

FastAPI-MCP é uma extensão nativa para o framework FastAPI que expõe seus endpoints de API como ferramentas MCP. Essas ferramentas podem ser descobertas e invocadas dinamicamente por agentes LLM compatíveis com MCP. Ao contrário dos conversores tradicionais, o FastAPI-MCP integra-se profundamente com a pilha ASGI do FastAPI, suporta autenticação e preservação de documentação de forma nativa e permite modelos de implantação unificados e separados para maior flexibilidade.

Como Configurar o FastAPI-MCP

  1. Instale o FastAPI-MCP usando seu gerenciador de pacotes preferido:
    • Com uv: uv add fastapi-mcp
    • Com pip: pip install fastapi-mcp
  2. Importe o FastAPI-MCP e inicialize-o com a instância da sua aplicação FastAPI.
  3. Use o método .mount() para expor seu servidor MCP, que irá gerar automaticamente endpoints de ferramentas MCP com base nas rotas existentes do FastAPI.
  4. Opcionalmente, configure a autenticação usando a injeção de dependência do FastAPI (por exemplo, Depends()), e personalize a documentação ou a implantação conforme suas necessidades.

Como Usar o FastAPI-MCP

  1. Adicione o seguinte à sua aplicação FastAPI: 
    from fastapi import FastAPI
from fastapi_mcp import FastApiMCP

app = FastAPI()
mcp = FastApiMCP(app)
mcp.mount()
  2. Uma vez montado, seu servidor MCP estará disponível em /mcp na URL base da sua aplicação.
  3. Todos os endpoints compatíveis do FastAPI se tornarão automaticamente ferramentas MCP, prontas para descoberta e invocação por clientes MCP, incluindo agentes LLM.
  4. Os endpoints mantêm seu esquema original, lógica de validação e autenticação, e quaisquer mudanças na sua aplicação FastAPI serão refletidas nas suas ferramentas MCP.
  5. Explore a documentação em fastapi-mcp.tadata.com e revise os exemplos para demonstrações práticas.

Principais Recursos

  • Integração de autenticação: Reutilize o modelo de dependência e segurança existente do FastAPI para endpoints MCP.
  • Configuração mínima: Exponha instantaneamente todos os seus endpoints do FastAPI como ferramentas MCP com uma chamada de método.
  • Suporte nativo do FastAPI: Aproveita o transporte ASGI para comunicação eficiente e direta.
  • Preservação de esquema e documentação: Mantém documentos, modelos e validação de campos do OpenAPI.
  • Implantação flexível: Implante o servidor MCP dentro da sua aplicação ou como um serviço independente.
  • Ecossistema abrangente: Integre LLMs e ferramentas externas compatíveis com MCP facilmente.

Casos de Uso

  • Disponibilize instantaneamente as APIs REST do seu negócio como ferramentas seguras acessíveis por LLM para fluxos de trabalho de agentes inteligentes.
  • Crie automação de fluxo de trabalho personalizada permitindo que LLMs chamem seus endpoints FastAPI como ferramentas MCP.
  • Prototipe e compartilhe novos recursos alimentados por IA sem embrulhar manualmente endpoints ou duplicação.
  • Conecte dados empresariais e APIs externas em um conjunto de ferramentas unificado e acessível por modelos.

FAQ

Q1: Preciso mudar meu código FastAPI para usar o FastAPI-MCP?
A: Não, você pode expor seus endpoints existentes como ferramentas MCP com nenhuma ou poucas mudanças, apenas inicializando e montando o FastAPI-MCP.

Q2: Posso usar a autenticação e as dependências do FastAPI com as ferramentas MCP?
A: Sim, o FastAPI-MCP suporta totalmente a autenticação e a injeção de dependência via Depends() do FastAPI, portanto, seu modelo de segurança permanece intacto.

Q3: É possível implantar o servidor MCP separadamente da minha aplicação FastAPI?
A: Sim, o FastAPI-MCP suporta modos de implantação unificados e separados, permitindo que você monte o servidor MCP dentro da sua aplicação ou como um serviço ASGI independente.

Q4: Como são tratados os esquemas de solicitação e resposta?
A: Os esquemas e a documentação de todos os endpoints são preservados, garantindo uma validação de entrada consistente e possibilidade de descoberta através das ferramentas MCP.