eiu-mcp-server

Model Context Protocol 서버로, Claude(또는 MCP 호환 LLM 클라이언트)가 EIU 데이터 API에 구조화되고 토큰 효율적인 방식으로 접근할 수 있게 해줍니다 — 약 200개 국가와 320개 경제 지표 시리즈, 과거 데이터 및 전망을 포함합니다.

세 가지 도구를 제공합니다:

참조 데이터는 세션당 한 번 가져와 메모리에 캐시되므로, browse와 search는 추가 API 호출이 들지 않습니다.

사전 요구 사항

• EIU API 개발자 포털 접근 권한. 셀프 서비스가 아닙니다. economicssupport@economist.com으로 이메일을 보내 개발자 포털 접근 권한을 요청하세요. 담당자가 수동으로 계정을 설정해 줍니다. 포털 이메일 주소, 포털 비밀번호, 포털에 표시된 API 키 — 이 세 가지가 모두 필요합니다.

• uv가 머신에 설치되어 있어야 합니다. 한 줄 명령:

  curl -LsSf https://astral.sh/uv/install.sh | sh

이 저장소를 클론하거나 가상 환경을 관리할 필요는 없습니다 — uvx가 git URL에서 모든 것을 처리합니다.

Related MCP server: EODHD MCP Server

설치

Claude Code

한 줄 설치입니다. EIU의 세 가지 값이 담긴 .env가 있는 폴더에서 실행하세요. 셸이 값을 읽으므로 자격 증명이 대화에 절대 나타나지 않습니다:

set -a; source .env; set +a
claude mcp add --scope user eiu \
  -e EIU_API_KEY="$EIU_API_KEY" \
  -e EIU_EMAIL="$EIU_EMAIL" \
  -e EIU_PASSWORD="$EIU_PASSWORD" \
  -- uvx --from git+https://github.com/joshua-bailey/eiu-mcp-server.git eiu-mcp-server

또는 .mcp.json에 항목을 직접 추가하세요:

{
  "mcpServers": {
    "eiu": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/joshua-bailey/eiu-mcp-server.git",
        "eiu-mcp-server"
      ],
      "env": {
        "EIU_API_KEY": "${EIU_API_KEY}",
        "EIU_EMAIL": "${EIU_EMAIL}",
        "EIU_PASSWORD": "${EIU_PASSWORD}"
      }
    }
  }
}

그런 다음 Claude Code를 다시 시작하세요. 세 가지 eiu_* 도구가 /mcp 아래에 표시되어야 합니다.

Claude Desktop

동일한 JSON 스니펫을 다음 위치의 mcpServers 아래에 넣으세요:

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

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

Claude Desktop은 ${VAR} 참조를 확장하지 않으므로 대신 실제 값을 넣으세요.

버전 고정

uvx는 기본적으로 main의 최신 커밋을 설치합니다. 태그된 릴리스로 고정하려면 git URL에 @<tag>를 추가하세요. 예:

"git+https://github.com/joshua-bailey/eiu-mcp-server.git@v0.1.0"

환경 변수

세 가지 모두 필요합니다. 서버는 이메일과 비밀번호로 로그인하여 베어러 토큰을 얻은 다음, 모든 요청에 API 키와 함께 해당 토큰을 전송합니다. 토큰은 메모리에 캐시되고 만료 전에 갱신됩니다.

사용 방법

MCP가 등록되면 Claude에게 다음과 같이 요청하세요:

• "EIU에서 'current account balance' 시리즈를 검색해 줘"

• "'consumer prices'를 다루는 EIU 시리즈 코드는 무엇이야?"

• "미국, 영국, 중국의 EIU 연간 GDP 성장률(DGDP)을 2015년부터 2030년까지 가져와 줘"

• "브라질, 멕시코, 칠레의 EIU 분기별 인플레이션 전망을 보여 줘"

Claude가 적절한 도구를 선택해 호출합니다.

코드

• 지역(Geographies) 은 대문자 ISO 두 글자 코드입니다: US, GB, CN, BR.

• 시리즈(Series) 는 대문자로 된 EIU 고유의 짧은 코드입니다(예: DGDP, DCPI). 추측하지 말고 eiu_search 또는 eiu_browse를 사용해 찾으세요.

• 빈도(Frequency) 는 Yearly, Quarterly 또는 Monthly 중 하나입니다.

eiu_get_data는 토큰 효율을 유지하기 위해 응답을 200개 데이터 포인트로 제한하며, 잘릴 경우 이를 명시합니다. 나머지를 보려면 날짜 범위나 국가 목록을 좁히세요.

API 참조

기본 API는 developer.eiu.com/help/overview에 문서화되어 있습니다. 서버는 https://api.eiu.com/v1과 통신합니다.

라이선스

MIT — LICENSE 참조. 이 저장소의 래퍼 코드에만 적용됩니다. 종속성은 각자의 라이선스를 유지합니다. EIU 데이터는 유료 구독이며, 그 이용 약관은 이 래퍼와 별도로 적용됩니다.