核心用法
boj-mcp 是日本银行（Bank of Japan）官方统计数据的 MCP 工具，通过访问 BOJ 扁平文件下载服务获取时间序列数据。支持以命令行或 MCP 协议交互方式查询，主要功能包括：
- 数据集浏览：
boj-mcp datasets列出所有可用数据集 - 数据检索：
boj-mcp data <dataset_name>获取指定数据集，支持 JSON/表格格式 - 智能搜索：
boj-mcp search <keyword>跨数据集或单数据集内搜索指标 - 本地缓存：首次下载后自动缓存，加速后续访问
显著优点
1. 官方数据源：直接来自日本银行 stat-search.boj.or.jp，权威性极高
2. 零门槛接入：无需注册、无需 API 密钥，完全公开访问
3. 覆盖全面：涵盖企业物価指数（CGPI）、サービス価格指数（SPPI）、资金循環統計（Flow of Funds）、国際収支統計、BIS 国際統計、短観（TANKAN）等核心宏观指标
4. 编码自动处理：内部自动转换 Shift_JIS 编码，用户无感知
5. 轻量部署：Python 包形式，支持 pip/uv 安装
潜在缺点与局限性
- 地域局限：仅覆盖日本经济数据，无法获取其他国家央行数据
- 更新延迟：依赖 BOJ 官方发布节奏，非实时数据流
- 功能单一：专注数据检索，无内置分析、可视化或统计建模功能
- 英文数据为主：部分数据集仅提供英文版（如
cgpi_m_en），日文原生细节可能丢失 - 无历史版本控制：无法追溯数据修订历史
适合人群
- 宏观经济研究人员、政策分析师
- 金融从业者关注日本市场（汇率、利率、货币政策）
- 学术机构进行日本经济实证研究
- 开发者构建日本经济数据仪表盘或自动化报告
常规风险
- 数据理解风险：CGPI/SPPI 等指数编制方法复杂，误读可能导致错误结论
- 汇率换算风险：涉及日元计价的国际比较时需额外处理
- 依赖单一来源：BOJ 数据修订或停更将影响工具可用性
- 缓存一致性：本地缓存若未及时刷新可能使用过旧数据
- 合规注意：虽为公开数据，商业使用建议确认 BOJ 利用規約