Skip to main content
Glama
carbon-footprint-mcp

carbon-footprint-mcp

Calculadora de Huella de Carbono (Servidor MCP)

Un servidor MCP (Model Context Protocol) para calcular huellas de carbono organizacionales a partir de extractos bancarios, exportaciones financieras y datos de actividad estructurados utilizando factores de emisión de GEI de la EPA.

Privacidad y seguridad ante todo

  • Se ejecuta 100% localmente en su máquina o servidor

  • No envía datos financieros a API externas ni proveedores en la nube

  • No almacena datos por defecto

  • Expone herramientas de cálculo y generación de informes de solo lectura

  • Funciona con Claude Desktop, Cursor y otros clientes MCP

Por qué existe esto

Si está preparando informes ESG, materiales de diligencia debida para inversores o revisiones internas de sostenibilidad, obtener una línea base de emisiones útil suele ser lento y manual.

Este servidor ayuda a convertir extractos bancarios sin procesar, exportaciones de Xero o QBO y entradas operativas estructuradas en un informe de huella de carbono en minutos. Asigna actividades a factores de emisión alineados con la EPA y produce resultados tanto en HTML como en Markdown.

La experiencia de usuario está diseñada para funcionar para organizaciones en cualquier país, mientras que la evaluación comparativa de electricidad actual sigue utilizando factores regionales eGRID de la EPA internamente.

Related MCP server: carbonstop-mcp

Qué hace

  1. Ingiere CSV bancarios, exportaciones de Xero o QBO y datos de actividad estructurados.

  2. Ayuda a categorizar las transacciones en fuentes de emisión probables como electricidad, combustible, viajes, transporte y residuos.

  3. Calcula las emisiones de Alcance 1, Alcance 2 y Alcance 3 utilizando factores de emisión de GEI de la EPA.

  4. Califica la intensidad de carbono por ingresos y número de empleados cuando se proporcionan esos datos.

  5. Genera informes pulidos en HTML y Markdown.

Fuente de los Factores de Emisión

Todos los factores de emisión se basan en el Centro de Factores de Emisión de GEI de la EPA (enero de 2025), incluidos los factores de electricidad eGRID 2023 y los potenciales de calentamiento global del IPCC AR5.

Las categorías cubiertas incluyen combustión estacionaria, combustión móvil, electricidad, vapor o calor, transporte, eliminación de residuos, viajes de negocios, desplazamientos de empleados y refrigerantes.

Instalación

Claude Desktop

  1. Instale uv.

  2. Abra la configuración de Claude Desktop y edite la configuración de MCP.

  3. Añada este servidor:

{
  "mcpServers": {
    "carbon-footprint": {
      "command": "uvx",
      "args": ["carbon-footprint-mcp"]
    }
  }
}
  1. Reinicie Claude Desktop.

Claude Code o Cursor

claude mcp add carbon-footprint -- uvx carbon-footprint-mcp

Desarrollo Local

git clone https://github.com/MayankTalwar0/carbon-footprint-mcp.git
cd carbon-footprint-mcp
pip install -e .
carbon-footprint-mcp

Herramientas MCP Disponibles

Herramienta

Descripción

computeEmissions(inputs_json)

Calcula las emisiones de GEI a partir de datos de actividad estructurados en los 3 alcances.

generateEmissionsReport(emissions_json, output_dir)

Genera un informe pulido en HTML y Markdown y lo guarda en el disco.

listEmissionFactors(category)

Enumera los factores de emisión disponibles para combustible, eGRID y residuos.

Categorías de Emisión Soportadas

Alcance

Categoría

Entrada Requerida

1

Combustión Estacionaria

Tipo de combustible y cantidad

1

Combustión Móvil

Tipo de combustible y galones

1

Fugas de Refrigerante

Tipo de gas, kg fugados y GWP

2

Electricidad Comprada

kWh y subregión eGRID

2

Vapor o Calor Comprado

mmBtu

3

Transporte y Distribución

Tipo de vehículo y distancia

3

Eliminación de Residuos

Material, toneladas cortas y método de eliminación

3

Viajes de Negocios

Modo de viaje y millas por pasajero

3

Desplazamientos de Empleados

Modo de desplazamiento y millas por pasajero

Puntuación de Intensidad de Carbono

Puntuación

tCO2e por $1M de Ingresos

Interpretación

Excelente

< 5

La mejor de su clase para operaciones de baja huella

Buena

5-20

Baja intensidad

Moderada

20-100

Típica para servicios y tecnología

Alta

100-500

Operaciones pesadas

Muy Alta

> 500

Intensidad muy alta

Licencia

MIT

Creado por SlickBooks

Creado por Mayank, fundador de SlickBooks.

Available Tools

3 tools
computeEmissionsA
Computes greenhouse gas emissions from structured activity data.

IMPORTANT: After calling this tool, you MUST call generateEmissionsReport with the
full output of this tool. Do not present results to the user without first saving
the report files. The _required_next_step field in the response will remind you.

Args:
    inputs_json: A JSON string containing categorized activity data.
                 Required fields vary by scope:
                 - Scope 1: stationary_combustion, mobile_combustion, refrigerants
                 - Scope 2: electricity_kwh, egrid_subregion, steam_mmbtu
                 - Scope 3: business_travel, employee_commuting, transportation, waste
                 Optional: annual_revenue, headcount (for scoring), period, source
Returns:
    JSON string containing computed emissions by scope, totals, breakdown,
    carbon intensity scores, and a _required_next_step instruction.

Inputs: inputs_json (required). Returns: result

generateEmissionsReportA
Generates a carbon footprint report in HTML + Markdown and saves to disk.

Args:
    emissions_json: JSON string - the direct output from computeEmissions.
    output_dir: Directory to save reports to. Default is current directory.
Returns:
    JSON with paths to both report files and the markdown content inline.

Inputs: emissions_json (required), output_dir. Returns: result

listEmissionFactorsA
Lists available emission factors for reference.

Args:
    category: One of 'fuels', 'egrid', 'waste', or 'all'.
Returns:
    JSON string listing available factors.

Inputs: category. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: computing emissions, generating reports, and listing emission factors. No functional overlap exists.

    Naming Consistency5/5

    All tool names follow a consistent camelCase verb_noun pattern: computeEmissions, generateEmissionsReport, listEmissionFactors.

    Tool Count5/5

    Three tools is appropriate for a focused carbon footprint calculator, covering computation, reporting, and reference without being too few or too many.

    Completeness4/5

    The tool set covers core workflow steps (compute, report, reference). Minor gaps like update/delete for reports or scenario comparison are not essential for the core purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      An MCP server that provides access to Northwood Capital Partners' portfolio carbon data, enabling MCP-compatible agents to query emissions, analyze decarbonization gaps, and simulate reduction initiatives through natural language.
      5
      -
    • A
      license
      B
      quality
      D
      maintenance
      MCP server enabling AI assistants to automatically perform carbon footprint modeling, product queries, and emission analysis via the Carbonstop Cloud API.
      8
      37 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Climatiq MCP server that calculates carbon footprints using emission factors, enabling users to list unit types and compute environmental impact.
      88 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for accessing and managing Banktivity personal finance data, enabling account, transaction, and budget operations through natural language.
      3
      MIT