Carbon Footprint Calculator

io.github.MayankTalwar0由 GitHub 帳號 MayankTalwar0 發布v1.0.1更新於 Oct 24, 2026

An MCP server for calculating carbon footprints from bank statements using EPA GHG emission factors.

發布方自己的服務:Carbon Fyi

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

依據銀行對帳單與活動資料,使用 EPA 排放係數計算組織碳足跡,並產出 HTML 與 Markdown 報告。

可以做什麼
可讀取銀行 CSV、Xero 或 QBO 匯出檔及結構化活動資料,並協助將交易歸類為電力、燃料、差旅、運輸與廢棄物等可能的排放來源。它使用 EPA 溫室氣體排放係數計算範疇一、範疇二與範疇三排放,在提供營收與員工人數時據此評估碳強度,並產出 HTML 與 Markdown 報告。工具包括 computeEmissions、generateEmissionsReport 與 listEmissionFactors。
適用情境
適合在準備 ESG 報告、投資盡職調查資料或內部永續檢視時,快速把原始財務匯出與營運輸入轉成排放基準。也適合已有銀行或會計匯出資料、希望避免手動試算表作業並採用 EPA 對齊係數的組織。
執行需求
以本機 stdio 程序執行,透過 uvx 從 PyPI 套件 carbon-footprint-mcp 安裝(需要 uv;本機開發需要 Python)。未宣告驗證、環境變數或標頭。可搭配 Claude Desktop、Claude Code、Cursor 及其他 MCP 用戶端使用。
安裝前請注意
此伺服器會讀取銀行對帳單與會計匯出等財務資料,即使它聲稱在本機執行、不將財務資料送往外部 API 且預設不儲存資料,仍應先確認要輸入的內容。generateEmissionsReport 會將報告檔案寫入你指定的目錄。排放係數以 EPA 為基礎,電力基準採用 EPA eGRID 區域係數,可能不適用於美國以外的營運。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Carbon Footprint Calculator,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Carbon Footprint Calculator (MCP Server)

An MCP (Model Context Protocol) server for calculating organizational carbon footprints from bank statements, financial exports, and structured activity data using EPA GHG emission factors.

Privacy and security first

  • Runs 100% locally on your machine or server
  • Sends no financial data to external APIs or cloud providers
  • Stores no data by default
  • Exposes read-only calculation and reporting tools
  • Works with Claude Desktop, Cursor, and other MCP clients

Why This Exists

If you are preparing ESG reporting, investor diligence materials, or internal sustainability reviews, getting to a usable emissions baseline is usually slow and manual.

This server helps turn raw bank statements, Xero or QBO exports, and structured operational inputs into a carbon footprint report in minutes. It maps activities to EPA-aligned emission factors and produces both HTML and Markdown outputs.

The user experience is designed to work for organizations in any country, while the current electricity benchmarking still uses EPA eGRID regional factors under the hood.

What It Does

  1. Ingests bank CSVs, Xero or QBO exports, and structured activity data.
  2. Helps categorize transactions into likely emission sources such as electricity, fuel, travel, shipping, and waste.
  3. Computes Scope 1, Scope 2, and Scope 3 emissions using EPA GHG emission factors.
  4. Scores carbon intensity by revenue and headcount when those inputs are provided.
  5. Generates polished HTML and Markdown reports.

Emission Factor Source

All emission factors are based on the EPA GHG Emission Factors Hub (January 2025), including eGRID 2023 electricity factors and IPCC AR5 global warming potentials.

Covered categories include stationary combustion, mobile combustion, electricity, steam or heat, transportation, waste disposal, business travel, employee commuting, and refrigerants.

Installation

Claude Desktop

  1. Install uv.
  2. Open Claude Desktop settings and edit the MCP config.
  3. Add this server:
json
{  "mcpServers": {    "carbon-footprint": {      "command": "uvx",      "args": ["carbon-footprint-mcp"]    }  }}
  1. Restart Claude Desktop.

Claude Code or Cursor

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

Local Development

bash
git clone https://github.com/MayankTalwar0/carbon-footprint-mcp.gitcd carbon-footprint-mcppip install -e .carbon-footprint-mcp

Available MCP Tools

ToolDescription
computeEmissions(inputs_json)Computes GHG emissions from structured activity data across all 3 scopes.
generateEmissionsReport(emissions_json, output_dir)Renders a polished HTML and Markdown report and saves it to disk.
listEmissionFactors(category)Lists available fuel, eGRID, and waste emission factors.

Supported Emission Categories

ScopeCategoryInput Required
1Stationary CombustionFuel type and quantity
1Mobile CombustionFuel type and gallons
1Refrigerant LeakageGas type, leaked kg, and GWP
2Purchased ElectricitykWh and eGRID subregion
2Purchased Steam or HeatmmBtu
3Transportation and DistributionVehicle type and distance
3Waste DisposalMaterial, short tons, and disposal method
3Business TravelTravel mode and passenger-miles
3Employee CommutingCommute mode and passenger-miles

Carbon Intensity Scoring

ScoretCO2e per $1M RevenueInterpretation
Excellent< 5Best-in-class for low-footprint operations
Good5-20Low intensity
Moderate20-100Typical for services and tech
High100-500Heavy operations
Very High> 500Very high intensity

License

MIT

Built By SlickBooks

Built by Mayank, founder of SlickBooks.

來源:README.md,提交 3faba70

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Carbon 整合