aussie-data-mcp

Name: aussie-data-mcp
Author: dylannnnn111

本地服务

github.com/dylannnnn111法律与政务01 天前更新

代码仓库

关于 aussie-data-mcp

aussie-data-mcp 让 Claude 等 MCP 客户端查询澳大利亚经济与交通数据，涵盖 ABS、RBA 和悉尼 Opal。工具返回带单位和变动计算的紧凑 JSON，并提供数据集发现与描述能力。

主要功能

01查询 CPI、就业和利率数据
02获取汇率及 RBA 统计序列
03查询悉尼 Opal 通勤趋势
04搜索并描述 ABS 数据集
05返回含单位和变化值的 JSON
06缓存响应六小时

适用场景

01比较悉尼租金与现金利率变化
02查看州级就业和失业指标
03分析澳元对多种货币的走势
04探索并获取 ABS 数据集

MCP 相关

作为 MCP 服务向客户端提供 ABS、RBA 和 Opal 数据查询工具。工具调用无需 API 密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "dylannnnn111-aussie-data": {
      "command": "npx",
      "args": [
        "-y",
        "aussie-data-mcp"
      ]
    }
  }
}

启动命令npx -y aussie-data-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmaussie-data-mcp0.2.1stdio

工具

收录的工具列表 · 更新于 3 天前

参数	类型	必填	说明
end	any	否	最新期间，格式为 YYYY-MM。省略则返回最新发布的数据，最多可返回该数据。
items	array	否	一个或多个值：all_groups、trimmed_mean、weighted_median、excluding_volatile_items、rents、housing、food、meals_out、electricity、automotive_fuel、insurance_and_financial，或原始 ABS CPI 指数代码。
start	string	否	最早期间，格式为 YYYY-MM（例如 2022-01）。省略则返回完整历史数据。
cities	array	否	首府城市；或使用 'australia' 表示八个首府城市的加权平均值。
measure	enum	否	index \| monthly_change \| annual_change
adjustment	enum	否	如果 ABS 未发布所请求的数据，则回退到 ABS 实际发布的数据（trimmed mean 仅经季节调整）。original \| seasonally_adjusted

详细介绍

Aussie Data MCP

一个 MCP 服务，可让 Claude（或任何 MCP 客户端）直接查询澳大利亚的经济和交通数据：ABS、RBA，以及来自 Commute Pulse 的悉尼 Opal 刷卡数据。

你可以询问“自 2022 年以来，悉尼租金相对于现金利率发生了怎样的变化？”这类问题，大模型会提取真实数据序列，而不是猜测。

工具

工具	可回答的问题	来源
`get_cpi`	按项目和首府城市划分的通胀数据（总体、截尾均值、租金、电费……）	ABS 月度 CPI
`get_labour_force`	按州划分的失业率、劳动参与率和就业情况	ABS 劳动力调查
`get_cash_rate`	RBA 现金利率目标，按月统计	RBA F1.1
`get_lending_rates`	住房贷款、商业贷款和信用卡利率（广告利率）	RBA F5
`get_exchange_rates`	澳元兑 18 种货币的汇率，以及 TWI	RBA F11.1
`rba_series`	其他任何 RBA 表格（先列出其序列，再获取数据）	RBA 统计表
`get_commute_pulse`	自 2020 年以来悉尼的周五出行差异和返岗模式	TfNSW Opal 刷卡数据
`abs_search_dataflows`	按关键词查找任何 ABS 数据集	ABS Data API
`abs_describe_dataflow`	ABS 数据集的维度和代码	ABS Data API
`abs_get_data`	按 SDMX 键获取任何 ABS 数据集	ABS Data API

每个工具都会返回精简的 JSON：包含命名序列及其单位、最新值、起始值和已计算好的区间变化，并附上注意事项。无需 API 密钥。

与 Claude Desktop 搭配使用

将以下内容添加到 claude_desktop_config.json（Settings > Developer > Edit Config）：

{
  "mcpServers": {
    "aussie-data": {
      "command": "npx",
      "args": ["-y", "aussie-data-mcp"]
    }
  }
}

或者从本地克隆的仓库中使用，指向构建文件："command": "node", "args": ["/path/to/aussie-data-mcp/dist/index.js"]。

npx -y aussie-data-mcp 会在每次 Claude 启动时运行最新发布的版本。若要固定到已检查过的版本，请指定版本："args": ["-y", "[email protected]"]。

大模型传入的每个 ID（RBA 表、ABS 数据流、SDMX 键、CPI 代码）都会在加入请求 URL 前，根据真实 ID 的格式进行校验。npm test 会覆盖这些检查。

开发

npm install
npm run smoke     # hits every live source and prints a summary
npm run inspect   # opens the MCP Inspector against the server

响应会缓存 6 小时（内存 + 临时目录）。可通过 AUSSIE_DATA_CACHE_TTL_HOURS 和 AUSSIE_DATA_CACHE_DIR 覆盖设置。

Commute Pulse 数据是该管道输出的打包快照。重新运行管道后，请使用 npm run sync:commute 刷新数据。

健康检查

每天早晨，GitHub Action 都会按照工具的调用方式访问实时 ABS 和 RBA API，并将结果追加到 health/log.jsonl：哪些检查通过、每项检查耗时，以及每项检查返回的最新时期和值。 health/latest.md 是最近一次运行的结果。如果某个数据源失败、未返回数据、返回的序列数量发生变化、数据倒退、增加了新备注或数据过时，该 Action 就会创建一个 health issue（或在已打开的 issue 下评论）。你可以使用 npm run health 自行运行检查。