eiu-mcp-server

Model Context Protocol サーバー。Claude(または MCP 互換の LLM クライアント)に、EIU データ API への構造化された、トークン効率の高いアクセスを提供します。約200か国、320の経済指標シリーズ、履歴と予測をカバーしています。

以下の3つのツールを公開しています:

リファレンスデータはセッションごとに1回取得され、メモリにキャッシュされるため、ブラウズと検索では追加の API 呼び出しは発生しません。

前提条件

• EIU API Developer Portal へのアクセス。 セルフサービスではありません。economicssupport@economist.com にメールで Developer Portal へのアクセスをリクエストしてください。アカウントは手動で設定されます。ポータルのメールアドレス、ポータルのパスワード、ポータルに表示されている API キーの3つすべてが必要です。

• マシンに uv がインストールされていること。ワンライナー:

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

このリポジトリをクローンしたり、仮想環境を管理したりする必要はありません。uvx が git URL からすべてを処理します。

Related MCP server: EODHD MCP Server

インストール

Claude Code

ワンラインインストールは、.env に EIU の3つの値が含まれるフォルダーから実行します。シェルが値を読み取るため、認証情報が会話に表示されることはありません:

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 を再起動します。3つの 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"

環境変数

3つすべてが必要です。サーバーはメールアドレスとパスワードでログインしてベアラートークンを取得し、そのトークンを API キーとともに毎回のリクエストで送信します。トークンはメモリにキャッシュされ、期限が切れる前に更新されます。

使い方

MCP が登録されると、Claude に次のようなことを依頼できます:

• 「EIU で経常収支のシリーズを検索して」

• 「消費者物価をカバーする EIU のシリーズコードはどれ？」

• 「2015年から2030年までの米国、英国、中国の EIU 年間 GDP 成長率 (DGDP) を取得して」

• 「ブラジル、メキシコ、チリの EIU 四半期インフレ予測を見せて」

Claude が適切なツールを選択して呼び出します。

コード

• 地域 (Geographies) は大文字の ISO 2文字コード: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 データは有料サブスクリプションであり、その利用規約はこのラッパーとは独立して適用されます。