GreenCalculus

Fatores de emissão de carbono com origem rastreada + cálculos com trilha de auditoria que uma IA pode citar.

Documentação

Servidor MCP GreenCalculus

Fatores de emissão de gases de efeito estufa com origem rastreada e cálculos de carbono com trilha de auditoria, como um servidor MCP. Cada valor retorna com sua célula de origem exata e uma versão de dados fixada — para que um agente devolva um número que uma pessoa possa citar e uma máquina possa reproduzir, em vez de um palpite.

Você precisa deste pacote?

Provavelmente não. O servidor é remoto, e se o seu cliente fala MCP remoto, você deve apontá-lo diretamente para a URL — nada para instalar, nada para atualizar:

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

Este pacote existe para os clientes que só conseguem iniciar um processo stdio local e para instalações do docker run. É uma ponte leve: encaminha cada mensagem JSON-RPC para o servidor remoto e retorna a resposta exatamente como recebida. Nenhum método é tratado de forma especial, então novas ferramentas aparecem aqui sem necessidade de lançamento.

Use via stdio

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

Ou com Docker — -i é obrigatório e -t deve ser omitido, porque o stdin/stdout do contêiner são o transporte e um TTY corrompe o fluxo:

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

Obtenha uma chave gratuita em https://greencalculus.com/developers — sem cartão. A descoberta (initialize, tools/list) funciona sem ela; chamar uma ferramenta exige a chave.

Ferramentas

Ferramenta	O que faz
`lookup_factor`	Busca um fator de emissão por chave, com sua origem e versão
`search_factors`	Pesquisa o corpus por texto livre
`resolve_factor`	Mapeia uma descrição confusa do mundo real para o fator mais adequado
`explain_absence`	Explica por que um fator não existe, em vez de retornar nada
`calculate_activity`	Atividade → emissões, com conversão de unidades e escopo do GHG Protocol
`calculate_electricity`	Eletricidade baseada em localização e em mercado
`calculate_embodied`	Carbono incorporado (EN 15978), explícito sobre etapas do ciclo de vida ausentes
`calculate_pcaf`	Emissões financiadas PCAF, com a trilha de auditoria
`calculate_freight`	Frete por modal, distância e carga
`calculate_spend`	EEIO baseado em gastos
`calculate_business_travel`	Viagens de negócios entre modais

Configuração

Variável	Padrão	Significado
`GREENCALCULUS_API_KEY`	—	Sua chave de API. `GC_API_KEY` é aceito como alias; o nome explícito tem prioridade.
`GREENCALCULUS_MCP_URL`	`https://mcp.greencalculus.com`	Substitui o endpoint.
`GREENCALCULUS_MCP_TIMEOUT_MS`	`120000`	Tempo limite por solicitação.

Os diagnósticos vão para o stderr. Nada além de JSON-RPC é gravado no stdout — um byte perdido ali corrompe a sessão.

Desenvolvimento

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

Também disponível

API REST e documentação — https://greencalculus.com/developers
SDKs de cliente (Python, JS/TS) — https://github.com/jeremiahsay/greencalculus-sdk
Registro oficial MCP — com.greencalculus/api
Smithery — https://smithery.ai/servers/greencalculus/api

Licença

MIT — veja LICENSE. A licença cobre esta ponte. Os dados de fatores de emissão retornados pela API carregam a licença de sua fonte subjacente, que é nomeada em cada resposta.