MCP Server Template (Python)

Una plantilla de servidor mínima de Model Context Protocol para Render. Haz un fork, añade tus propias herramientas y despliega.

Qué se incluye

• Un servidor MCP funcional que utiliza el MCP Python SDK con transporte HTTP Streamable

• Autenticación mediante token Bearer a través de MCP_API_TOKEN (se genera automáticamente al desplegar)

• Una herramienta de ejemplo (hello) para mostrar el patrón

• Un endpoint /health para las comprobaciones de salud de Render

• Un Blueprint render.yaml para el despliegue con un clic

• Un archivo AGENTS.md para que los asistentes de codificación con IA puedan generarte nuevas herramientas

Nota: Esta plantilla se despliega en el plan gratuito por defecto. Los servicios gratuitos se suspenden después de 15 minutos de inactividad, lo que provoca arranques en frío de 30 a 60 segundos en la siguiente solicitud. Los clientes MCP pueden agotar el tiempo de espera durante esta demora. Para un uso fiable, actualiza a un plan de pago en el Render Dashboard: el plan Starter mantiene tu servicio en funcionamiento de forma continua.

Related MCP server: MCP Server Template (TypeScript)

Primeros pasos en local

git clone https://github.com/render-examples/mcp-server-python.git
cd mcp-server-python
pip install -r requirements.txt
python server.py

El servidor se inicia en http://localhost:10000. El endpoint MCP está en /mcp.

Ejecutar las pruebas

pip install -r requirements.txt
pytest

Autenticación

El servidor autentica las solicitudes mediante un token Bearer. El Blueprint de Render genera automáticamente un MCP_API_TOKEN aleatorio en el primer despliegue.

Para encontrar tu token después de desplegar, ve a Render Dashboard > your service > Environment y copia el valor de MCP_API_TOKEN.

Los clientes deben incluir el token en la cabecera Authorization:

Authorization: Bearer YOUR_TOKEN

Cuando MCP_API_TOKEN no está definido (p. ej., durante el desarrollo local), la autenticación está desactivada y se permiten todas las solicitudes.

Gestionar tu token

Después del despliegue inicial, el token es tuyo para gestionarlo:

• Rótalo actualizando MCP_API_TOKEN en el Render Dashboard, en Environment. El servicio se reinicia automáticamente con el nuevo valor.

• Genera un nuevo token con cualquiera de estas opciones:

  • openssl rand -base64 32

  • python3 -c "import secrets; print(secrets.token_urlsafe(32))"

  • El generador de un gestor de contraseñas (1Password, Bitwarden, etc.)

• No hagas commit de los tokens al control de versiones. Utiliza variables de entorno o archivos .env (que están en .gitignore).

• Para configuraciones multiusuario o de producción, considera actualizar a OAuth 2.1.

Conexión a tu servidor MCP

Después de desplegar en Render, tu endpoint MCP está disponible en:

https://your-service-name.onrender.com/mcp

Cursor

Añádelo al .cursor/mcp.json de tu proyecto:

{
  "mcpServers": {
    "my-mcp-server": {
      "url": "https://your-service-name.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Claude Desktop

Añádelo a la configuración de Claude Desktop:

{
  "mcpServers": {
    "my-mcp-server": {
      "type": "streamable-http",
      "url": "https://your-service-name.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Codex

codex mcp add --transport streamable-http \
  --url https://your-service-name.onrender.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN" \
  my-mcp-server

O añádelo a .codex/config.toml:

[mcp_servers.my-mcp-server]
url = "https://your-service-name.onrender.com/mcp"
http_headers = { Authorization = "Bearer YOUR_TOKEN" }

Añadir herramientas

Añade herramientas a server.py decorando una función con @mcp.tool():

@mcp.tool()
def fetch_weather(city: str, units: str = "celsius") -> str:
    """Get the current weather for a city."""
    # your implementation here
    return f"Weather for {city}"

El docstring se convierte en la descripción de la herramienta, que los clientes MCP muestran a los LLM. Escribe siempre una clara.

Este repositorio incluye un archivo AGENTS.md. Si utilizas un asistente de codificación con IA (Cursor, Copilot, Codex, Windsurf, etc.), puedes pedirle que "añada una nueva herramienta" y seguirá automáticamente las convenciones de AGENTS.md.

Estructura del proyecto

server.py              MCP server with example tool and health check
requirements.txt       Python dependencies
render.yaml            Render Blueprint for deployment
.env.example           Environment variable reference
tests/test_server.py   Test suite (auth, health, tool calls)
pyproject.toml         pytest configuration
AGENTS.md              Instructions for AI coding assistants
CLAUDE.md              Pointer to AGENTS.md for Claude Code

Más información

• Especificación MCP

• MCP Python SDK

• Render Blueprints