Climatiq MCP 서버

탄소 배출량 계산을 위해 Climatiq API에 접근하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이를 통해 AI 비서가 실시간으로 탄소 배출량을 계산하고 기후 영향에 대한 통찰력을 제공할 수 있습니다.

데모

https://github.com/user-attachments/assets/c253d6d1-ccf6-4c14-965e-6023ba2a0296

https://github.com/user-attachments/assets/d61c1181-acf6-4d9f-9a48-537fc64ac4c3

특징

이 MCP 서버는 Climatiq API와 통합되어 AI 도우미에 대한 탄소 배출량 계산을 제공합니다.

도구

set-api-key : 인증에 사용되는 Climatiq API 키를 구성합니다.
전기 배출량 : 전기 소비로 인한 탄소 배출량 계산
여행 배출량 : 자동차, 비행기 또는 기차로 여행할 때 발생하는 탄소 배출량을 계산합니다.
검색-배출-계수 : Climatiq 데이터베이스에서 특정 배출 계수를 검색합니다.
custom-emission-calculation : 특정 배출 계수를 사용하여 사용자 정의 계산 수행
클라우드 컴퓨팅 배출량 : 클라우드 컴퓨팅 리소스 사용으로 인한 배출량 계산
freight-emission : 화물 운송으로 인한 배출량 계산
조달-배출 : 조달 지출로 인한 배출량 계산
hotel-emission : 호텔 숙박으로 인한 배출량 계산
여행 지출 : 여행 경비로 인한 배출량 계산

자원

탄소 계산 결과는 climatiq://calculation/{id} URI 체계를 사용하여 리소스로 노출됩니다.
각 리소스에는 배출 계수 및 계산 결과에 대한 자세한 정보가 포함되어 있습니다.

프롬프트

기후 영향 설명 : 특정 배출량 계산의 기후 영향에 대한 자연어 설명을 생성합니다.

설치

출처에서

이 프로젝트에서는 가상 환경 및 종속성 관리를 위해 uv 사용합니다. 먼저 uv를 설치 하세요.

지엑스피1

uv를 사용하여

uv pip install climatiq-mcp-server

API 키 구성

서버가 작동하려면 Climatiq API 키가 필요합니다. API 키를 제공하는 방법은 다음과 같습니다.

환경 변수 : 서버를 시작하기 전에 CLIMATIQ_API_KEY 환경 변수를 설정하세요.
export CLIMATIQ_API_KEY=your_climatiq_api_key
설치 중 구성 :
CLIMATIQ_API_KEY=your_climatiq_api_key uv pip install climatiq-mcp-server
set-api-key 도구 : AI 어시스턴트 내에서 런타임 중에 set-api-key 도구를 사용하여 구성합니다.
구성 파일 : 프로젝트 디렉토리에 .env 파일을 만듭니다.
CLIMATIQ_API_KEY=your_climatiq_api_key

Climatiq API 키를 받으려면:

app.climatiq.io 에 가입하세요
API 키 가져오기 의 지침을 따르세요.

서버 실행

서버는 명령줄에서 직접 시작할 수 있습니다.

climatiq-mcp-server

AI Assistant 설정

클로드 데스크탑

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

"mcpServers": {
  "climatiq-mcp-server": {
    "command": "climatiq-mcp-server",
    "env": {
      "CLIMATIQ_API_KEY": "your_climatiq_api_key"
    }
  }
}

예제 및 유틸리티

예제 디렉토리

examples/ 디렉토리에는 다음이 포함되어 있습니다.

climatiq.ipynb : Climatiq를 사용한 직접 API 사용을 보여주는 Jupyter 노트북
simple_test.py : MCP 프로토콜 없이 API 통합을 직접 테스트하기 위한 간단한 유틸리티

# Run the simple test
python examples/simple_test.py

유틸리티 스크립트

utils/ 디렉토리에는 여러 가지 유용한 스크립트가 포함되어 있습니다.

테스트 클라이언트

test_client.py 스크립트는 모든 도구, 프롬프트, 리소스를 테스트합니다.

python utils/test_client.py

LLM 예제 클라이언트

llm_example_client.py 스크립트는 대규모 언어 모델(예: Claude)이 Climatiq MCP 서버와 상호 작용하는 방법을 보여줍니다.

python utils/llm_example_client.py

주요 특징:

오류 처리 및 시간 초과 관리 기능을 갖춘 완전한 API 래퍼
계산 내역을 보존하기 위한 리소스 및 결과 캐싱
자연어 설명을 생성하는 방법을 보여주는 예시 프롬프트
전기방출, 이동방출, 배출계수 검색 기능을 시연합니다.

CLI 도구

MCP 서버의 복잡성 없이 직접 API에 액세스할 수 있는 명령줄 인터페이스 도구:

# For electricity emissions
python utils/climatiq_cli.py electricity --energy 1000 --unit kWh --region US

# For travel emissions
python utils/climatiq_cli.py travel --mode car --distance 100 --unit km --region US

MCP 서버 스크립트 실행

run_mcp_server.py 스크립트를 사용하면 설치하지 않고도 서버를 직접 실행할 수 있습니다.

python utils/run_mcp_server.py

핵심 개념

활동 ID

활동 ID는 Climatiq API의 핵심 개념으로, 유사한 배출 요소를 함께 그룹화합니다.

Climatiq 데이터베이스의 각 배출 요인에는 활동 ID가 있습니다.
활동 ID는 동일한 활동을 여러 지역, 연도, 출처 등에 걸쳐 설명하는 배출 요소를 그룹화합니다.
예: electricity-supply_grid-source_residual_mix (전기), passenger_vehicle-vehicle_type_car (자동차 여행)

계산 방법

Climatiq MCP 서버는 여러 가지 계산 방법을 지원합니다.

이동 배출량에 대한 거리 기반 방법
출발지-목적지 쌍을 사용한 고급 여행 계산
지출 데이터만 있는 경우 지출 기반 방식
특정 배출 계수를 사용한 직접 계산

문제 해결

API 키 문제

환경 또는 .env 파일에서 CLIMATIQ_API_KEY 올바르게 설정되었는지 확인하세요.
Climatiq 대시보드에서 API 키가 활성화되어 있는지 확인하세요.
API 키가 올바르게 작동하는지 확인하려면 examples/simple_test.py 사용하세요.

고급 사용법

특정 도구와 고급 기능의 사용에 대한 자세한 내용은 docs/README.md 파일을 참조하세요.

클리마틱 소개

Climatiq은 탄소 인텔리전스를 위한 강력한 API를 제공하여 전기 사용, 운송, 조달 등에서 발생하는 배출량을 계산할 수 있도록 지원합니다. 이 MCP 서버는 모델 컨텍스트 프로토콜을 통해 AI 어시스턴트가 이러한 기능을 사용할 수 있도록 지원합니다.

Climatiq에 대한 자세한 내용은 climatiq.io에서 확인하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

Climatiq MCP Server

Integrations