mcp-server-starter

Esqueleto para crear un servidor del Protocolo de Contexto de Modelo (MCP) en Python. Haz un fork de esto cuando necesites exponer un conjunto personalizado de herramientas/datos a Claude Desktop, Claude Code o cualquier cliente compatible con MCP.

¿Qué es un servidor MCP?

MCP es un protocolo abierto que permite a los clientes de modelos de lenguaje llamar a herramientas y fuentes de datos externas a través de una interfaz estándar. Un servidor MCP es el pequeño proceso que aloja esas herramientas: tú escribes las funciones, el protocolo se encarga de la detección y la invocación.

Inicio rápido

Instálalo directamente desde este repositorio con pipx:

pipx install git+https://github.com/roderickch01/mcp-server-starter.git

Luego regístralo en tu cliente MCP. Para Claude Desktop, edita ~/.config/Claude/claude_desktop_config.json (Linux), ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), o %APPDATA%\Claude\claude_desktop_config.json (Windows) y añade:

{
  "mcpServers": {
    "starter": {
      "command": "mcp-server-starter"
    }
  }
}

Una copia de este fragmento se encuentra en examples/claude_desktop_config.json. Reinicia tu cliente y las herramientas echo y add deberían aparecer.

Qué incluye

Dos herramientas de demostración para verificar la conexión:

echo(text: str) -> str — devuelve "echo: {text}"
add(a: int, b: int) -> int — devuelve la suma

Ambas se encuentran en src/mcp_server_starter/server.py (menos de 30 líneas).

Añadir tu propia herramienta

Abre server.py y decora cualquier función con @mcp.tool(). La firma, las sugerencias de tipo y el docstring se convierten automáticamente en el esquema de la herramienta:

@mcp.tool()
def reverse(text: str) -> str:
    """Return the input string reversed."""
    return text[::-1]

Reinstala (pipx reinstall mcp-server-starter) y reinicia tu cliente MCP. La nueva herramienta será detectable.

Desarrollo local

git clone https://github.com/roderickch01/mcp-server-starter.git
cd mcp-server-starter
python -m venv .venv && source .venv/bin/activate
pip install -e .
mcp-server-starter   # runs the server over stdio