Servidor MCP de Climatiq

Un servidor de Protocolo de Contexto de Modelo (MCP) para acceder a la API de Climatiq y calcular las emisiones de carbono. Esto permite a los asistentes de IA realizar cálculos de carbono en tiempo real y proporcionar información sobre el impacto climático.

Manifestación

https://github.com/user-attachments/assets/c253d6d1-ccf6-4c14-965e-6023ba2a0296

https://github.com/user-attachments/assets/d61c1181-acf6-4d9f-9a48-537fc64ac4c3

Características

Este servidor MCP se integra con la API de Climatiq para proporcionar cálculos de emisiones de carbono para asistentes de IA:

Herramientas

set-api-key : configura la clave API de Climatiq utilizada para la autenticación
emisiones de electricidad : Calcular las emisiones de carbono derivadas del consumo de electricidad
Emisiones de viajes : Calcule las emisiones de carbono de los viajes en coche, avión o tren.
search-emission-factors : Busca factores de emisión específicos en la base de datos Climatiq
cálculo-de-emisiones-personalizado : Realiza cálculos personalizados utilizando factores de emisión específicos
cloud-computing-emission : Calcular las emisiones derivadas del uso de recursos de computación en la nube
freight-emission : Calcular las emisiones del transporte de mercancías
emisiones de compras : Calcular las emisiones derivadas del gasto en compras
hotel-emission : Calcular las emisiones de las estancias en hoteles
gastos de viaje : Calcular las emisiones derivadas de los gastos de viaje

Recursos

Los resultados del cálculo de carbono se exponen como recursos con un esquema URI climatiq://calculation/{id}
Cada recurso contiene información detallada sobre un factor de emisión y los resultados del cálculo.

Indicaciones

explicación del impacto climático : Generar explicaciones en lenguaje natural sobre el impacto climático de cálculos de emisiones específicas.

Instalación

De la fuente

Este proyecto utiliza uv para el entorno virtual y la gestión de dependencias. Asegúrese de instalar uv primero.

# Clone the repository
git clone https://github.com/your-org/climatiq-mcp-server.git
cd climatiq-mcp-server

# Create a virtual environment
uv venv

# Activate the virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate

# Install dependencies with development extras
uv sync --dev --extra all

Usando uv

uv pip install climatiq-mcp-server

Configuración de la clave API

El servidor requiere una clave API de Climatiq para funcionar. Tiene varias opciones para proporcionarla:

Variable de entorno : configure la variable de entorno CLIMATIQ_API_KEY antes de iniciar el servidor
export CLIMATIQ_API_KEY=your_climatiq_api_key
Configuración durante la instalación :
CLIMATIQ_API_KEY=your_climatiq_api_key uv pip install climatiq-mcp-server
Herramienta set-api-key : utilice la herramienta set-api-key para configurarla durante el tiempo de ejecución dentro del asistente de IA
Archivo de configuración : Cree un archivo .env en el directorio del proyecto:
CLIMATIQ_API_KEY=your_climatiq_api_key

Para obtener una clave API de Climatiq:

Regístrate en app.climatiq.io
Siga las instrucciones en Obtener claves API

Ejecución del servidor

El servidor se puede iniciar directamente desde la línea de comandos:

climatiq-mcp-server

Configuración en Asistentes de IA

Escritorio de Claude

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

"mcpServers": {
  "climatiq-mcp-server": {
    "command": "climatiq-mcp-server",
    "env": {
      "CLIMATIQ_API_KEY": "your_climatiq_api_key"
    }
  }
}

Ejemplos y utilidades

Directorio de ejemplos

El directorio examples/ contiene:

climatiq.ipynb : Un cuaderno Jupyter que demuestra el uso directo de la API con Climatiq
simple_test.py : Una utilidad sencilla para probar la integración de API directamente sin el protocolo MCP

# Run the simple test
python examples/simple_test.py

Scripts de utilidad

El directorio utils/ contiene varios scripts útiles:

Cliente de prueba

El script test_client.py prueba todas las herramientas, indicaciones y recursos:

python utils/test_client.py

Cliente de ejemplo de LLM

El script llm_example_client.py demuestra cómo un modelo de lenguaje grande (como Claude) podría interactuar con el servidor Climatiq MCP:

python utils/llm_example_client.py

Características principales:

Envoltorio de API completo con gestión de errores y gestión de tiempos de espera
Almacenamiento en caché de recursos y resultados para preservar el historial de cálculos
Ejemplos de indicaciones que muestran cómo generar explicaciones en lenguaje natural
Demuestra capacidades de búsqueda de emisiones de electricidad, emisiones de viajes y factores de emisión.

Herramienta CLI

Una herramienta de interfaz de línea de comandos para acceso directo a la API sin la complejidad del servidor MCP:

# For electricity emissions
python utils/climatiq_cli.py electricity --energy 1000 --unit kWh --region US

# For travel emissions
python utils/climatiq_cli.py travel --mode car --distance 100 --unit km --region US

Ejecutar el script del servidor MCP

Utilice el script run_mcp_server.py para ejecutar directamente el servidor sin instalar:

python utils/run_mcp_server.py

Conceptos clave

Identificadores de actividad

Un ID de actividad es un concepto clave en la API de Climatiq que agrupa factores de emisión similares:

Cada factor de emisión en la base de datos de Climatiq tiene un ID de actividad
Los identificadores de actividad agrupan los factores de emisión que describen la misma actividad en diferentes regiones, años, fuentes, etc.
Ejemplos: electricity-supply_grid-source_residual_mix (electricidad), passenger_vehicle-vehicle_type_car (viajes en coche)

Métodos de cálculo

El servidor Climatiq MCP admite múltiples métodos de cálculo:

Método basado en la distancia para las emisiones de viajes
Cálculos de viajes avanzados con pares origen-destino
Método basado en gastos para cuando solo tienes datos de gastos
Cálculos directos utilizando factores de emisión específicos

Solución de problemas

Problemas con la clave API

Asegúrese de que CLIMATIQ_API_KEY esté configurado correctamente en su entorno o archivo .env
Verifique que la clave API esté activa en su panel de Climatiq
Utilice examples/simple_test.py para comprobar si su clave API funciona correctamente

Uso avanzado

Para obtener documentación detallada sobre el uso de herramientas específicas y funciones avanzadas, consulte el archivo docs/README.md .

Acerca de Climatiq

Climatiq ofrece una potente API para la inteligencia de carbono, que permite calcular las emisiones derivadas del consumo de electricidad, el transporte, las compras y más. Este servidor MCP facilita el acceso de estas capacidades a los asistentes de IA mediante el Protocolo de Contexto de Modelo.

Para obtener más información sobre Climatiq, visita climatiq.io .

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Climatiq MCP Server

Integrations