ABS MCP

ABS MCP服务器

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

特性

• 通过SDMX-ML API动态发现所有可用的ABS数据集
• 使用可选过滤器查询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                # Main server implementation
├── services/
│   └── abs/
│       ├── ABSApiClient.ts # ABS API communication
│       └── DataFlowService.ts # Data flow management and caching
├── types/
│   └── abs.ts             # TypeScript type definitions
└── utils/
    └── logger.ts          # Logging configuration

实现细节

ABS API客户

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

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

数据流服务

这 DataFlowService 类管理ABS数据流：

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

日志记录

使用Winston的综合测井系统：

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

与Claude Desktop集成

1. 如果克劳德桌面正在运行，请关闭它
2. 启动ABS MCP服务器： npm start
3. 启动克劳德桌面
4. ABS工具应出现在“可用MCP工具”窗口中

API文档

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

• SDMX-ML文档
• ABS API文件

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 提交拉取请求

许可证

MIT许可证