GreenCalculus

Factores de emisión de carbono con fuente verificada + cálculos con trazabilidad de auditoría que una IA puede citar.

Documentación

Servidor MCP de GreenCalculus

Factores de emisión de gases de efecto invernadero con fuentes verificadas y cálculos de carbono con trazabilidad de auditoría, como servidor MCP. Cada valor devuelve su celda de origen exacta y una versión de datos fijada, de modo que un agente entrega un número que una persona puede citar y una máquina puede reproducir, en lugar de una suposición.

¿Necesitas este paquete?

Probablemente no. El servidor es remoto y, si tu cliente habla MCP remoto, deberías apuntarlo directamente a la URL: nada que instalar, nada que actualizar:

{
  "mcpServers": {
    "greencalculus": {
      "url": "https://mcp.greencalculus.com",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Este paquete existe para los clientes que solo pueden lanzar un proceso local stdio, y para instalaciones de docker run. Es un puente ligero: reenvía cada mensaje JSON-RPC al servidor remoto y devuelve la respuesta tal cual. Ningún método recibe un tratamiento especial, por lo que las nuevas herramientas aparecen aquí sin necesidad de una versión.

Úsalo a través de stdio

{
  "mcpServers": {
    "greencalculus": {
      "command": "npx",
      "args": ["-y", "greencalculus-mcp"],
      "env": { "GREENCALCULUS_API_KEY": "YOUR_KEY" }
    }
  }
}

O con Docker: se requiere -i y se debe omitir -t, porque la entrada/salida estándar del contenedor son el transporte y una TTY corrompe el flujo:

{
  "mcpServers": {
    "greencalculus": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "GREENCALCULUS_API_KEY", "greencalculus/mcp"],
      "env": { "GREENCALCULUS_API_KEY": "YOUR_KEY" }
    }
  }
}

Obtén una clave gratuita en https://greencalculus.com/developers — sin tarjeta. El descubrimiento (initialize, tools/list) funciona sin ella; llamar a una herramienta la requiere.

Herramientas

Herramienta	Qué hace
`lookup_factor`	Obtiene un factor de emisión por clave, con su fuente y versión
`search_factors`	Busca en el corpus por texto libre
`resolve_factor`	Asigna una descripción del mundo real desordenada al factor que mejor coincide
`explain_absence`	Explica por qué un factor no existe, en lugar de devolver nada
`calculate_activity`	Actividad → emisiones, con conversión de unidades y alcance del GHG Protocol
`calculate_electricity`	Electricidad basada en ubicación y en mercado
`calculate_embodied`	Carbono incorporado (EN 15978), explícito sobre las etapas del ciclo de vida faltantes
`calculate_pcaf`	Emisiones financiadas PCAF, con la pista de auditoría
`calculate_freight`	Flete por modo, distancia y carga
`calculate_spend`	EEIO basado en gasto
`calculate_business_travel`	Viajes de negocio entre modos

Configuración

Variable	Predeterminado	Significado
`GREENCALCULUS_API_KEY`	—	Tu clave de API. Se acepta `GC_API_KEY` como alias; el nombre explícito tiene prioridad.
`GREENCALCULUS_MCP_URL`	`https://mcp.greencalculus.com`	Sobrescribe el punto final.
`GREENCALCULUS_MCP_TIMEOUT_MS`	`120000`	Tiempo de espera por solicitud.

Los diagnósticos van a stderr. Nada más que JSON-RPC se escribe jamás en stdout: un byte suelto allí corrompe la sesión.

Desarrollo

npm test                      # unit tests, no network
node bin/greencalculus-mcp.js # reads JSON-RPC on stdin
docker build -t greencalculus/mcp .

También disponible

API REST y documentación — https://greencalculus.com/developers
SDK de cliente (Python, JS/TS) — https://github.com/jeremiahsay/greencalculus-sdk
Registro oficial de MCP — com.greencalculus/api
Smithery — https://smithery.ai/servers/greencalculus/api

Licencia

MIT — consulta LICENSE. La licencia cubre este puente. Los datos de factores de emisión devueltos por la API llevan la licencia de su fuente subyacente, que se nombra en cada respuesta.