InfluxDB MCP サーバー

InfluxDB OSS API v2を使用してInfluxDBインスタンスへのアクセスを公開するモデルコンテキストプロトコル（MCP）サーバー。主にClaude Codeによって構築されています。

特徴

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

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

リソース

サーバーは次のリソースを公開します。

組織リスト: influxdb://orgs
- InfluxDBインスタンス内のすべての組織を表示します
バケットリスト: influxdb://buckets
- すべてのバケットとそのメタデータを表示します
バケット測定: influxdb://bucket/{bucketName}/measurements
- 指定されたバケット内のすべての測定値を一覧表示します
クエリデータ: influxdb://query/{orgName}/{fluxQuery}
- Fluxクエリを実行し、結果をリソースとして返します

ツール

サーバーは次のツールを提供します:

write-data : 時系列データをラインプロトコル形式で書き込む
- パラメータ: org、bucket、data、precision（オプション）
query-data : Fluxクエリを実行する
- パラメータ: org、クエリ
create-bucket : 新しいバケットを作成する
- パラメータ: name、orgID、retentionPeriodSeconds（オプション）
create-org : 新しい組織を作成する
- パラメータ: 名前、説明（オプション）

プロンプト

サーバーは、次のプロンプトテンプレートを提供します。

flux-query-examples : 一般的な Flux クエリの例
line-protocol-guide : InfluxDB ラインプロトコル形式のガイド

構成

サーバーには次の環境変数が必要です:

INFLUXDB_TOKEN (必須): InfluxDB API の認証トークン
INFLUXDB_URL (オプション): InfluxDBインスタンスのURL (デフォルトはhttp://localhost:8086 )
INFLUXDB_ORG (オプション): 特定の操作のデフォルトの組織名

インストール

オプション1: npxで実行（推奨）

# Run directly with npx
INFLUXDB_TOKEN=your_token npx influxdb-mcp-server

オプション2: グローバルにインストールする

# Install globally
npm install -g influxdb-mcp-server

# Run the server
INFLUXDB_TOKEN=your_token influxdb-mcp-server

オプション3: ソースから

# Clone the repository
git clone https://github.com/idoru/influxdb-mcp-server.git
cd influxdb-mcp-server

# Install dependencies
npm install

# Run the server
INFLUXDB_TOKEN=your_token npm start

Claude for Desktopとの統合

claude_desktop_config.jsonにサーバーを追加します。

npx の使用（推奨）

{
  "mcpServers": {
    "influxdb": {
      "command": "npx",
      "args": ["influxdb-mcp-server"],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

ローカルにインストールした場合

{
  "mcpServers": {
    "influxdb": {
      "command": "node",
      "args": ["/path/to/influxdb-mcp-server/src/index.js"],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

コード構造

サーバーコードはモジュール構造に編成されています。

src/
- index.js - メインサーバーのエントリポイント
- config/ - 設定関連ファイル
  - env.js - 環境変数の処理
- utils/ - ユーティリティ関数
  - influxClient.js - InfluxDB API クライアント
  - loggerConfig.js - コンソールロガーの設定
- handlers/ - リソースとツールのハンドラー
  - organizationsHandler.js - 組織の一覧
  - bucketsHandler.js - バケットの一覧
  - measurementsHandler.js - 測定値リスト
  - queryHandler.js - クエリ実行
  - writeDataTool.js - データ書き込みツール
  - queryDataTool.js - クエリツール
  - createBucketTool.js - バケット作成ツール
  - createOrgTool.js - 組織作成ツール
- prompts/ - プロンプトテンプレート
  - fluxQueryExamplesPrompt.js - Flux クエリの例
  - lineProtocolGuidePrompt.js - ラインプロトコルガイド

この構造により、保守性が向上し、テストが容易になり、関心の分離が明確になります。

テスト

リポジトリには、次のような包括的な統合テストが含まれています。

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

テストを実行するには:

npm test

ライセンス

マサチューセッツ工科大学

InfluxDB MCP Server

Integrations