Abs

🚀 ABS Data Flow Protocol (MCP) Server

An MCP (Model Context Protocol) server that provides access to the Australian Bureau of Statistics (ABS) data API. This server allows AI assistants to query and analyze ABS statistical data through the SDMX-ML API.

✨ Features

• Dynamically discover all available ABS datasets via the SDMX-ML API.
• Support querying ABS datasets with optional filters.
• Support multiple data formats (JSON, CSV, XML).
• Achieve seamless integration with AI assistants based on the MCP protocol.
• Implement a caching system to improve performance.
• Provide comprehensive logging and error handling.

📦 Installation

npm install

🚀 Quick Start

Prerequisites

• Node.js 18 or higher.
• npm 8 or higher.

Build

npm run build

Run

npm start

Development Tools

• npm run build: Build TypeScript code.
• npm start: Run the server.
• npm run inspector: Run the MCP inspector for testing.

📚 Documentation

Project Structure

src/
├── index.ts                # Main server implementation file
├── services/
│   └── abs/
│       ├── ABSApiClient.ts # ABS API communication class
│       └── DataFlowService.ts # Data flow management and caching service class
├── types/
│   └── abs.ts             # TypeScript type definitions
└── utils/
    └── logger.ts          # Logging configuration

Implementation Details

ABS API Client

The ABSApiClient class handles communication with the ABS data API:

• Use the SDMX-ML format for data exchange.
• Support multiple response formats (JSON, CSV, XML).
• Implement error handling and logging.
• Configure timeout and retry mechanisms.

Data Flow Service

The DataFlowService class manages ABS data flows:

• Dynamically obtain available datasets from the ABS API.
• Implement caching functionality with a configurable refresh interval.
• Provide methods to query specific datasets.
• Handle data conversion and formatting.

Logging

Use a comprehensive logging system with Winston:

• Provide debug-level logs for development.
• Use structured JSON format logs.
• Support console and file transport options.
• Offer configurable log levels and formats.

Integration with Claude Desktop

1. Close the running Claude Desktop.
2. Start the ABS MCP server: npm start.
3. Start Claude Desktop.
4. The ABS tool should appear in the "Available MCP Tools" window.

API Documentation

For more information about the ABS data API:

• SDMX-ML Documentation
• ABS API Documentation

Contribution

1. Fork the repository.
2. Create a feature branch.
3. Make modifications.
4. Submit a pull request.

📄 License

MIT License