DEMO Country MCP Server

Servidor MCP de DEMO Country

Un servidor MCP modular que expone herramientas para búsquedas de países y estados. Listo para usar como CLI o agente conectable.

---

Inicio rápido

1. Clona y configura tu entorno

   git clone <REPO_URL> cd mcp-server

2. Compila el paquete

   python -m build

3. Instala globalmente con pipx

   pipx install dist/country_mcp_server-*.whl --force

4. Ejecuta el servidor

   country-mcp-server

   O, para desarrollo con la interfaz de Inspector:

   mcp dev country_server_mcp/main.py

---

Añade tus propias herramientas

• Coloca los nuevos módulos en country_server_mcp/tools/.
• Cada módulo debe definir una función register(mcp) y añadir herramientas usando @mcp.tool().
• Importa y llama al register(mcp) de cada nueva herramienta en main.py.
• Recompila y reinstala con pipx install dist/… --force.

---

Ejemplo de estructura del proyecto

country_server_mcp/
    __init__.py
    main.py
    tools/
        __init__.py
        countries.py
        states.py
pyproject.toml
README.md

---

Uso como agente MCP

Añade a tu configuración del orquestador:

{
  "mcpServers": {
    "country": {
      "command": "country-mcp-server",
      "args": []
    }
  }
}

---

Notas

• Si actualizas herramientas, recompila y reinstala el paquete.
• Asegúrate de que tu binario CLI esté en tu PATH (~/.local/bin para pipx por defecto).
• Para modo de desarrollo, instalación editable: pip install -e .

---

¡Avísame si lo quieres aún más minimalista o necesitas un texto específico de "cómo empezar" para un equipo!