Sign inSign up

programmerrdai/mcp-carbon-calculator

By programmerrdai

•Updated about 1 year ago

MCP server computes CO₂e for electricity & gas, exposes JSON-RPC tools for LLM integration

Image
Machine learning & AI
0

10K+

programmerrdai/mcp-carbon-calculator repository overview

⁠MCP Carbon Calculator

Docker Python 3.13+

Model Context Protocol server for calculating CO₂ emissions from electricity and gas consumption across Australia.

⁠Quick Start

docker pull programmerrdai/mcp-carbon-calculator:latest
docker run -p 6277:6277 -p 6274:6274 programmerrdai/mcp-carbon-calculator:latest

⁠Features

  • Electricity emissions for all Australian states
  • Gas emissions with metro/non-metro differentiation
  • JSON-RPC WebSocket API
  • Built-in web testing interface
  • AI assistant integration (Claude, ChatGPT)

⁠API Tools

ToolParameters
electricity_emissionkillo_watt_hours, state
gas_emission_metrogiga_joules, gas_type
gas_emission_non_metrogiga_joules, gas_type

⁠Docker Compose

services:
  carbon-calculator:
    image: programmerrdai/mcp-carbon-calculator:latest
    ports:
      - "6277:6277"
      - "6274:6274"

⁠Example Usage

curl -X POST http://localhost:6277 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "electricity_emission",
      "arguments": {"killo_watt_hours": 100, "state": "Victoria"}
    }
  }'

Response: 86 kg CO₂e for 100 kWh in Victoria

⁠Data Source

Based on Australian National Greenhouse Accounts 2024

Tag summary

Content type

Image

Digest

sha256:7c0c5e60a…

Size

53 MB

Last updated

about 1 year ago

docker pull programmerrdai/mcp-carbon-calculator