MCP Remoto com SSE

Crie um servidor MCP remoto usando Server-Sent Events (SSE) com FastAPI.

Este projeto demonstra como criar um servidor MCP remoto usando Server-Sent Events (SSE) com FastAPI, permitindo que clientes acessem ferramentas via HTTP.

Funcionalidades Principais

• Criar um servidor MCP com FastAPI.
• Expor ferramentas através de Server-Sent Events (SSE).
• Demonstrar a interação do cliente com o servidor remoto.
• Combinar endpoints REST com ferramentas MCP em um único servidor.

Tecnologias Utilizadas

• FastAPI
• FastMCP
• Loguru
• MCP
• Uvicorn
• httpx

Começando

Pré-requisitos

• Python 3.12+
• uv

Instalação

1. Clone o repositório.
2. Navegue até o diretório do projeto: cd projects/mcp-sse
3. Instale as dependências usando uv: uv sync

Uso

1. Execute o servidor: uv run server.py
2. Execute o cliente: uv run client.py

Estrutura do Projeto

mcp-sse/
├── README.md      # Documentação do projeto
├── client.py      # Script do cliente MCP
├── pyproject.toml # Dependências do projeto
├── server.py      # Script do servidor MCP
└── uv.lock        # Arquivo de lock das dependências

Detalhes da Implementação

• O arquivo server.py define um servidor MCP com uma ferramenta get_weather.
• O arquivo client.py demonstra como se conectar ao servidor remoto e invocar a ferramenta get_weather.
• FastAPI é usado para criar o servidor e expor o endpoint SSE.

Contribuindo

1. Faça um fork do repositório.
2. Crie sua branch de funcionalidade.
3. Envie um pull request.