Servidor MCP em 30 Minutos

O que é MCP?
MCP (Modelo de Protocolo de Contexto) está se tornando a maneira padrão para aplicações de IA (Claude, Cursor, VS Code, etc.) descobrirem e chamarem ferramentas externas. Pense nisso como "USB‑C para IA."

Um servidor MCP → funciona com todos os clientes compatíveis com MCP.

Construa um Servidor MCP de Pesquisa SERP
Aqui está um servidor MCP completo e minimalista que expõe a capacidade de busca do TalorData:

Arquivo: server.py

import os
import asyncio
from mcp.server import Server, Tool
from talordata import TalorClient

client = TalorClient(api_key=os.environ["TALOR_API_KEY"])
server = Server("talordata-search")

@server.tool()
async def search(query: str, engine: str = "google") -> list:
    """Pesquise na web e retorne resultados estruturados."""
    results = await client.async_search(q=query, engine=engine)
    return [
        {
            "title": r.title,
            "link": r.link,
            "snippet": r.snippet
        }
        for r in results.organic[:10]
    ]

if __name__ == "__main__":
    server.run()

Execute-o:

export TALOR_API_KEY="sua-chave-api"
python server.py

Como Usar

1. Claude Desktop: Adicione a URL do servidor à sua configuração MCP.
2. Cursor / VS Code: Aponte o cliente MCP para seu servidor em execução.
3. LangChain / LlamaIndex: Use o adaptador MCP para registrar a ferramenta. Uma vez configurado, seu cliente de IA pode chamar automaticamente search() – nenhum código extra necessário.

Por que Construir um Servidor MCP?

• Uma construção, muitos clientes – funciona com Claude, Cursor, VS Code e mais.
• Descoberta – sua ferramenta aparece nos diretórios MCP.
• Desacoplado – atualize sua ferramenta sem tocar na lógica do agente.

Obtenha o código completo do servidor MCP + docs:
👉 github.com/Talordata/talordata-mcp