convez.ai
MCP Server
Nikeandocean

carbon-factor-matcher

Nikeandocean/carbon-factor-matcher

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server for intelligent emission factor matching using LLM-powered semantic search

Instalação

$npx convez-ai Nikeandocean/carbon-factor-matcher

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
v1.0.8
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

Carbon Factor Matcher — MCP Server for Carbon Accounting

An MCP (Model Context Protocol) server that connects LLMs with carbon footprint databases. It provides intelligent emission factor matching for carbon accounting, LCA (Life Cycle Assessment), and ESG reporting applications.

What is this MCP?

Carbon Factor Matcher helps AI agents and LLM-based applications find the most appropriate emission factors from standardized environmental databases. It uses a two-stage hybrid search algorithm:

  1. Embedding-based rough filtering — Semantic similarity to find candidate factors
  2. LLM-based fine ranking — AI-powered selection with reasoning and confidence scores

Supported Databases

  • ELCD — European Reference Life Cycle Database (included)
  • ecoinvent 3.10 — Swiss Centre for Life Cycle Inventories (Pro license required)

Key Features

  • 5-dimension data quality rating (technology, geography, source, time, factor type)
  • Multi-language support (Chinese/English activity descriptions)
  • MCP-compatible — works with Claude, Cursor, and any MCP client

Installation

Add to your MCP settings (claude_desktop_config.json or .cursor/mcp.json):

{
  "mcpServers": {
    "carbon-factor-matcher": {
      "command": "npx",
      "args": ["-y", "@nikeandocean/carbon-factor-matcher"],
      "env": {
        "CARBON_FACTOR_LICENSE_KEY": "your-license-key",
        "LLM_API_KEY": "your-api-key",
        "LLM_BASE_URL": "https://api.deepseek.com",
        "LLM_MODEL": "deepseek-chat"
      }
    }
  }
}

Pricing

This is a commercial MCP server. You can purchase the access license key via PayPro Global.

PlanPriceFeatures
Free$0ELCD database, basic search, top 3 results
Pro$5 (one-time)ELCD + ecoinvent, hybrid matching, unlimited results, data quality rating

Purchase License Key

👉 Buy Pro License on PayPro Global

After purchase, you will receive a license key via email. Set it as the CARBON_FACTOR_LICENSE_KEY environment variable.

Configuration

VariableDescriptionDefault
CARBON_FACTOR_LICENSE_KEYYour license key (empty = Free tier)—
LLM_API_KEYLLM API key (DeepSeek/OpenAI)—
LLM_BASE_URLLLM endpoint URLhttps://api.deepseek.com
LLM_MODELLLM model namedeepseek-chat
CARBON_FACTOR_DATA_DIRPath to factor databasedata/factors

Available Tools

factor_match

Match activity data to the best emission factor using semantic search.

Input:

{
  "activity_data": "Factory in Shenzhen, 10kV industrial electricity, 2024, semiconductor fab",
  "top_k": 10
}

Output:

{
  "selected_factor": {
    "id": "elec-cn-south-10kv-2024",
    "name": "Electricity, 10kV, South China Grid",
    "value": 0.6101,
    "unit": "kgCO2e/kWh"
  },
  "confidence": 0.92,
  "reason": "Best match for industrial electricity in South China region",
  "alternatives": [...]
}

factor_search

Search emission factors by keyword with optional filters.

Input:

{
  "query": "diesel",
  "category": "fuel",
  "limit": 10
}

factor_detail

Get full metadata for a specific factor.

Input:

{
  "factor_id": "elec-cn-south-10kv-2024"
}

System Requirements

  • Python 3.11+
  • LLM API key (DeepSeek recommended, or any OpenAI-compatible endpoint)
  • 2GB+ RAM for embedding model

Tech Stack

  • MCP SDK — Model Context Protocol implementation
  • Sentence Transformers — Semantic embedding (shibing624/text2vec-base-chinese)
  • DeepSeek/OpenAI — LLM-based factor ranking
  • SQLite — Usage tracking
  • Python 3.11+ — Runtime

Support

License

This is proprietary software. See LICENSE for details.


© 2024 Carbon Factor Matcher. All rights reserved.

Ver o original no GitHub

Bom para

Relacionados