Conectando Ferramentas Locais com FastMCP: Do Zero ao Primeiro Servidor

Neste tutorial prático, você aprenderá a construir um servidor MCP leve em Python com FastMCP e conectá-lo diretamente ao Google Antigravity para permitir que seu assistente execute funções customizadas no seu computador.

---

🛠️ Passo 1: Instalação das Dependências

No seu terminal:

pip install mcp fastmcp

---

🐍 Passo 2: Criando seu Servidor MCP (meu_servidor.py)

from mcp.server.fastmcp import FastMCP
import os

# Inicializa o servidor FastMCP
mcp = FastMCP("MeuServidorLocal")

@mcp.tool()
def listar_arquivos(diretorio: str) -> list[str]:
    """Lista todos os arquivos de um diretório local."""
    if not os.path.exists(diretorio):
        return [f"Erro: O diretório {diretorio} não existe."]
    return os.listdir(diretorio)

@mcp.tool()
def somar_numeros(a: float, b: float) -> float:
    """Calcula a soma determinística de dois números."""
    return a + b

if __name__ == "__main__":
    mcp.run(transport="stdio")

---

🔌 Passo 3: Declarando o Servidor no Google Antigravity

No seu arquivo mcp_config.json:

{
  "mcpServers": {
    "meu-servidor-local": {
      "command": "python",
      "args": ["c:/caminho/para/meu_servidor.py"]
    }
  }
}

Agora, ao conversar com o Antigravity no workspace, o agente terá acesso automático às ferramentas listar_arquivos e somar_numeros!