RMI Utility Transition Hub — Servidor MCP

Un servidor MCP que carga los datos públicos del Utility Transition Hub de RMI en DuckDB. Cualquier cliente MCP (Claude Code, Claude Desktop) puede consultar las emisiones de las empresas de servicios públicos de EE. UU., la combinación de generación y la alineación climática mediante lenguaje natural.

Configuración

1. Instalar dependencias

pip install fastmcp duckdb pandas pymupdf

O con uv:

uv init rmi-mcp-uth
cd rmi-mcp-uth
uv add fastmcp duckdb pandas pymupdf

2. Descargar los datos de RMI

Descarga los datos del Utility Transition Hub y extráelos en un directorio data/ junto a server.py:

mkdir data
cd data

curl -LO https://utilitytransitionhub.rmi.org/static/data_download/data_download_all_pt_1.zip
curl -LO https://utilitytransitionhub.rmi.org/static/data_download/data_download_all_pt_2.zip

unzip data_download_all_pt_1.zip
unzip data_download_all_pt_2.zip

3. Probar con el MCP Inspector

npx @modelcontextprotocol/inspector python server.py

Esto abre una interfaz de navegador donde puedes llamar a cada herramienta, explorar los recursos e inspeccionar el tráfico del protocolo.

4. Conectar un cliente

El servidor utiliza transporte stdio. Cualquier cliente MCP puede conectarse a él. A continuación se muestran las configuraciones para Claude Code y Claude Desktop.

Si usas uv, apunta el cliente a uv y deja que resuelva el entorno. Sin uv, apúntalo a un python que tenga las dependencias instaladas y usa una ruta absoluta en ambos casos.

Claude Code

Añade el servidor con la CLI:

claude mcp add rmi-mcp-uth -- uv --directory /absolute/path/to/rmi-mcp-uth run server.py

O, sin uv:

claude mcp add rmi-mcp-uth -- python /absolute/path/to/server.py

Por defecto es un servidor local: disponible solo para ti, en el directorio desde el que ejecutaste el comando. Usa --scope user para que esté disponible en todos los proyectos, o --scope project para escribir un archivo .mcp.json que se incluya en git y se comparta con los colaboradores:

claude mcp add rmi-mcp-uth --scope project -- uv --directory /absolute/path/to/rmi-mcp-uth run server.py

Verifica la conexión:

claude mcp list

Deberías ver rmi-mcp-uth: ... - ✔ Connected. Dentro de una sesión, /mcp lista las herramientas, los recursos y los prompts del servidor. Los prompts aparecen como comandos de barra (/mcp__rmi-mcp-uth__decarbonization_assessment), y los recursos se pueden adjuntar con @rmi-mcp-uth:rmi://data-dictionary.

Para eliminarlo: claude mcp remove rmi-mcp-uth.

Claude Desktop

Añade esto al archivo de configuración de Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "rmi-mcp-uth": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/rmi-mcp-uth", "run", "server.py"]
    }
  }
}

O, sin uv:

{
  "mcpServers": {
    "rmi-mcp-uth": {
      "command": "python",
      "args": ["/absolute/path/to/server.py"]
    }
  }
}

Reinicia Claude Desktop. Aparecerá un icono de martillo en el cuadro de mensaje. Haz clic en él para ver tus herramientas.

Related MCP server: US ISO Grid MCP

Qué se expone

Herramientas

Recursos

Prompts

Conversaciones de ejemplo

• "¿Qué empresas de servicios públicos de Colorado tienen las mayores emisiones de CO2?"

• "Muéstrame la tendencia de emisiones de Xcel Energy durante la última década"

• "Compara la combinación de generación de Duke Energy y Southern Company"

• "¿Qué empresas de servicios públicos están más lejos de la trayectoria de 1.5°C?"

• "¿Qué proporción de la generación de las empresas de servicios públicos de EE. UU. proviene de energías renovables?"

Reconstrucción de la base de datos

Elimina utility_hub.duckdb y reinicia el servidor. Se reconstruye automáticamente a partir de los archivos CSV.

Licencia de los datos

Los datos de RMI Utility Transition Hub están bajo la licencia CC BY 4.0.