ABS 数据流协议 (MCP) 服务器

一个提供访问澳大利亚统计局（ABS）数据 API 的 MCP（模型上下文协议）服务器。该服务器允许 AI 助手通过 SDMX-ML API 查询和分析 ABS 统计数据。

特性

• 动态发现所有可用的 ABS 数据集，通过 SDMX-ML API
• 支持使用可选过滤器查询 ABS 数据集
• 支持多种数据格式（JSON、CSV、XML）
• 基于 MCP 协议实现与 AI 助手的无缝集成
• 缓存系统以提高性能
• 全面的日志记录和错误处理

安装

npm install

开发

先决条件

• Node.js 18 或更高版本
• npm 8 或更高版本

构建

npm run build

运行

npm start

开发工具

• npm run build：构建 TypeScript 代码
• npm start：运行服务器
• npm run inspector：运行 MCP 检查器以进行测试

项目结构

src/
├── index.ts                # 主服务器实现文件
├── services/
│   └── abs/
│       ├── ABSApiClient.ts # ABS API 通信类
│       └── DataFlowService.ts # 数据流管理与缓存服务类
├── types/
│   └── abs.ts             # TypeScript 类型定义
└── utils/
    └── logger.ts          # 日志记录配置

实现细节

ABS API 客户端

ABSApiClient 类处理与 ABS 数据 API 的通信：

• 使用 SDMX-ML 格式进行数据交换
• 支持多种响应格式（JSON、CSV、XML）
• 实现了错误处理和日志记录
• 配置超时时间和重试机制

数据流服务

DataFlowService 类管理 ABS 数据流：

• 动态从 ABS API 获取可用的数据集
• 实现缓存功能，支持配置刷新间隔
• 提供查询特定数据集的方法
• 处理数据转换和格式化

日志记录

使用 Winston 的全面日志系统：

• 为开发提供调试级别的日志
• 结构化的 JSON 格式日志
• 支持控制台和文件传输选项
• 可配置的日志级别和格式

集成与Claude Desktop

1. 关闭正在运行的 Claude Desktop
2. 启动 ABS MCP 服务器：npm start
3. 启动 Claude Desktop
4. ABS 工具应在“可用 MCP 工具”窗口中出现

API 文档

有关 ABS 数据 API 的更多信息：

• SDMX-ML 文档
• ABS API 文档

贡献

1. 叉取仓库
2. 创建功能分支
3. 进行修改
4. 提交拉取请求

许可证

MIT 许可证