RMI Utility Transition Hub — MCP 서버

RMI가 공개한 Utility Transition Hub 데이터를 DuckDB에 로드하는 MCP 서버입니다. 모든 MCP 클라이언트(Claude Code, Claude Desktop)는 자연어를 통해 미국 유틸리티의 배출량, 발전 구성, 기후 정합성을 조회할 수 있습니다.

설정

1. 의존성 설치

pip install fastmcp duckdb pandas pymupdf

또는 uv 사용 시:

uv init rmi-mcp-uth
cd rmi-mcp-uth
uv add fastmcp duckdb pandas pymupdf

2. RMI 데이터 다운로드

Utility Transition Hub에서 데이터를 다운로드하고 server.py 옆의 data/ 디렉토리에 압축을 푸세요:

mkdir data
cd data

curl -LO https://utilitytransitionhub.rmi.org/static/data_download/data_download_all_pt_1.zip
curl -LO https://utilitytransitionhub.rmi.org/static/data_download/data_download_all_pt_2.zip

unzip data_download_all_pt_1.zip
unzip data_download_all_pt_2.zip

3. MCP Inspector로 테스트

npx @modelcontextprotocol/inspector python server.py

이 명령을 실행하면 브라우저 UI가 열리며, 각 도구를 호출하고 리소스를 탐색하고 프로토콜 트래픽을 검사할 수 있습니다.

4. 클라이언트 연결

이 서버는 stdio 전송을 사용합니다. 모든 MCP 클라이언트가 연결할 수 있습니다. Claude Code 및 Claude Desktop용 구성은 아래에 나와 있습니다.

uv를 사용하는 경우 클라이언트를 uv로 지정하고 환경을 자동으로 해석하게 하세요. uv를 사용하지 않는 경우 의존성이 설치된 python을 지정하고, 두 경우 모두 절대 경로를 사용하세요.

Claude Code

CLI로 서버를 추가하세요:

claude mcp add rmi-mcp-uth -- uv --directory /absolute/path/to/rmi-mcp-uth run server.py

또는 uv를 사용하지 않는 경우:

claude mcp add rmi-mcp-uth -- python /absolute/path/to/server.py

기본적으로 이 서버는 local 서버입니다. 즉, 명령을 실행한 디렉토리에서 사용자만 사용할 수 있습니다. --scope user를 사용하면 모든 프로젝트에서 사용할 수 있고, --scope project를 사용하면 git에 커밋되어 협업자와 공유되는 .mcp.json 파일이 작성됩니다:

claude mcp add rmi-mcp-uth --scope project -- uv --directory /absolute/path/to/rmi-mcp-uth run server.py

연결을 확인하세요:

claude mcp list

rmi-mcp-uth: ... - ✔ Connected가 표시되어야 합니다. 세션 내에서 /mcp는 서버의 도구, 리소스, 프롬프트를 나열합니다. 프롬프트는 슬래시 명령(/mcp__rmi-mcp-uth__decarbonization_assessment)으로 표시되며, 리소스는 @rmi-mcp-uth:rmi://data-dictionary로 첨부할 수 있습니다.

제거하려면: claude mcp remove rmi-mcp-uth.

Claude Desktop

이 내용을 Claude Desktop 구성 파일에 추가하세요:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "rmi-mcp-uth": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/rmi-mcp-uth", "run", "server.py"]
    }
  }
}

또는 uv를 사용하지 않는 경우:

{
  "mcpServers": {
    "rmi-mcp-uth": {
      "command": "python",
      "args": ["/absolute/path/to/server.py"]
    }
  }
}

Claude Desktop을 다시 시작하세요. 메시지 상자에 망치 아이콘이 나타납니다. 그것을 클릭하면 도구를 볼 수 있습니다.

Related MCP server: US ISO Grid MCP

제공 항목

도구

리소스

프롬프트

대화 예시

• "어느 콜로라도 유틸리티가 CO2 배출량이 가장 높나요?"

• "Xcel Energy의 지난 10년간 배출량 추이를 보여줘"

• "Duke Energy와 Southern Company의 발전 구성을 비교해줘"

• "어느 유틸리티가 1.5°C 경로에서 가장 많이 벗어났나요?"

• "미국 유틸리티 발전에서 재생에너지가 차지하는 비중은 얼마인가요?"

데이터베이스 재구축

utility_hub.duckdb를 삭제하고 서버를 다시 시작하세요. CSV에서 자동으로 다시 구축합니다.

데이터 라이선스

RMI Utility Transition Hub 데이터는 CC BY 4.0에 따라 라이선스가 부여됩니다.