Influxdb MCP Server

🚀 InfluxDB MCP サーバー

このサーバーは、InfluxDB OSS API v2 を使用して、InfluxDB インスタンスへのアクセスを提供する Model Context Protocol (MCP) サーバーです。主にClaude Codeを使用して構築されています。

✨ 主な機能

このMCPサーバーは、以下の機能を提供します。

• リソース：組織、バケット、測定データへのアクセス
• ツール：データの書き込み、クエリの実行、データベースオブジェクトの管理
• プロンプトテンプレート：一般的なFluxクエリの例とLine Protocol形式のガイド

📦 リソース

このサーバーは、以下のリソースを公開しています。

1. 組織のリスト：influxdb://orgs

   • InfluxDBインスタンス内のすべての組織を表示します。

2. バケットのリスト：influxdb://buckets

   • すべてのバケットとそのメタデータを表示します。

3. バケットの測定値：influxdb://bucket/{bucketName}/measurements

   • 指定されたバケット内のすべての測定値をリストします。

4. データのクエリ：influxdb://query/{orgName}/{fluxQuery}

   • Fluxクエリを実行し、結果をリソースとして返します。

🛠️ ツール

サーバーは、以下のツールを提供します。

1. write-data：行プロトコル形式で時系列データを書き込みます。

   • パラメータ：組織、バケット、データ、精度（オプション）

2. query-data：Fluxクエリを実行します。

   • パラメータ：組織、クエリ

3. create-bucket：新しいバケットを作成します。

   • パラメータ：名前、組織、メタデータ（オプション）

4. create-org：新しい組織を作成します。

   • パラメータ：組織名

💡 プロンプトテンプレート

1. Fluxクエリの例のプロンプト：一般的なFluxクエリの例とガイドを提供します。
2. Line Protocol形式のガイド：Line Protocol形式でデータを書き込む方法を説明します。

⚙️ 設定

InfluxDB MCPサーバーを設定するには、以下の環境変数を追加してください。

INFLUXDB_URL=http://localhost:8086
INFLUXDB_TOKEN=your-influxdb-token

📦 インストール

npxを使用したインストール

npx influx-mcp-server@latest --install

グローバルインストール

npm install -g influx-mcp-server

ソースコードからのインストール

1. リポジトリをクローンします。

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. 依存関係をインストールします。

   npm install
   

3. サーバーを起動します。

   npm start
   

💻 コード構造

src/
├── main.ts                 # メインプログラムのエントリーポイント
├── config.ts              # 設定ファイル
└── modules/
    ├── influxdb/          # InfluxDB関連のモジュール
    │   └── connection.ts  # 接続管理
    ├── prompts/           # プロンプトテンプレート
    │   ├── flux-query-examples.prompt.ts      # Fluxクエリの例のプロンプト
    │   └── line-protocol-guide.prompt.ts     # Line Protocolガイド
    └── utils/             # ユーティリティ関数
        └── logger.ts       # ログ記録ツール

🧪 テスト

リポジトリには、以下の内容を含む包括的な統合テストが含まれています。

• Dockerコンテナ内のInfluxDBインスタンスを起動する
• サンプルデータを入力する
• すべてのMCPサーバー機能をテストする

テストを実行するには、以下のコマンドを実行してください。

npm test

📄 ライセンス

MIT