eiu-mcp-server

一个Model Context Protocol服务器，为Claude（或任何兼容MCP的LLM客户端）提供对EIU数据API的结构化、token高效访问——涵盖约200个国家和320个经济指标序列，包括历史数据和预测。

它提供三个工具：

参考数据在每次会话中获取一次并缓存在内存中，因此浏览和搜索不会产生额外的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文件的文件夹运行。Shell会读取这些值，因此凭据永远不会出现在您的对话中：

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"

环境变量

这三项都是必需的。服务器使用电子邮件和密码登录以获取bearer令牌，然后在每个请求中将该令牌与API密钥一起发送。令牌缓存在内存中，并在过期前刷新。

使用方法

MCP注册后，您可以要求Claude做类似以下的事情：

• “在EIU中搜索经常账户余额序列”

• “哪些EIU序列代码涵盖消费者价格？”

• “获取美国、英国和中国2015年至2030年的EIU年度GDP增长（DGDP）数据”

• “显示巴西、墨西哥和智利的EIU季度通胀预测”

Claude会选择正确的工具并调用它。

代码

• 地理区域是ISO两字母大写代码：US、GB、CN、BR。

• 序列是EIU自己的大写短代码，例如DGDP、DCPI。请使用eiu_search或eiu_browse查找它们，而不要猜测。

• 频率是Yearly、Quarterly或Monthly之一。

eiu_get_data最多返回200个数据点以保持token高效，并在截断时明确说明这一点。缩小日期范围或国家列表即可查看其余数据。

API参考

底层API的文档位于developer.eiu.com/help/overview。服务器与https://api.eiu.com/v1通信。

许可证

MIT——参见LICENSE。仅适用于本仓库中的包装代码。依赖项保留其各自的许可证。EIU数据是付费订阅，其使用条款独立于本包装器适用。