Influxdb MCP Server

🚀 InfluxDB MCP 服務器

InfluxDB MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它藉助 InfluxDB OSS API v2，為用戶提供對 InfluxDB 實例的便捷訪問。該項目主要使用 Claude Code 構建。

🚀 快速開始

要使用 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
   

✨ 主要特性

此 MCP 服務器具備豐富的功能，主要包括以下幾個方面：

• 資源：可對組織、存儲桶和測量數據進行訪問。
• 工具：支持寫入數據、執行查詢以及管理數據庫對象等操作。
• 提示模板：提供常見 Flux 查詢示例和 Line Protocol 格式指南。

📦 安裝指南

使用 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
   

📚 詳細文檔

資源

該服務器暴露了以下資源：

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

🔧 技術細節

代碼結構

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 許可證。