Abs

🚀 ABS データフロープロトコル (MCP) サーバー

このサーバーは、オーストラリア統計局（ABS）のデータ API へのアクセスを提供する MCP（モデルコンテキストプロトコル）サーバーです。AI アシスタントが SDMX - ML API を通じて ABS の統計データを照会および分析できるようにします。

🚀 クイックスタート

この ABS データフロープロトコル (MCP) サーバーを使用することで、AI アシスタントが 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                # メインサーバー実装ファイル
├── 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 ライセンス