Crear servidores MCP custom: tutorial paso a paso

Que es MCP

MCP (Model Context Protocol) es un protocolo abierto de Anthropic que estandariza como conectar LLMs con fuentes de datos y herramientas externas. En vez de definir tools manualmente en cada request, un servidor MCP expone herramientas que Claude descubre automaticamente.

Arquitectura

Host (Claude Code/Desktop) ↔ Client (protocolo MCP) ↔ Server (tu código). El server expone tools, resources y prompts. El client los descubre y los ofrece al LLM.

Crear un servidor con Python SDK

from mcp.server import Server
from mcp.types import Tool, TextContent

server = Server("mi-servidor")

@server.tool()
async def buscar_clientes(query: str) -> list[TextContent]:
    """Busca clientes en la base de datos."""
    # Tu logica aqui
    results = db.search(query)
    return [TextContent(type="text", text=str(results))]

server.run()

Tools vs Resources

Tools: acciones que el LLM puede ejecutar (buscar, crear, modificar). Resources: datos que el LLM puede leer (ficheros, URLs, bases de datos).

Configurar en Claude Code

Anadir al .mcp.json del proyecto:

{
  "mcpServers": {
    "mi-servidor": {
      "command": "python",
      "args": ["server.py"]
    }
  }
}

Servidores MCP populares

PostgreSQL, GitHub, Slack, Supabase, Notion, Filesystem. La comunidad crece rápido. Lista completa en github.com/modelcontextprotocol.