Seatunnel

🚀 SeaTunnel MCP 服務器

SeaTunnel MCP 服務器是一個藉助大語言模型（LLM）接口與 SeaTunnel 進行交互的模型上下文協議（MCP）服務器，為用戶提供便捷的作業管理和系統信息查詢等功能。

🚀 快速開始

為了更好地瞭解 Seatunnel MCP 的功能和使用方法，我們提供了一個演示視頻。請參考以下鏈接或直接查看項目文檔目錄中的視頻文件。

https://www.youtube.com/watch?v=JaLA8EkZD7Q

⚠️ 重要提示

如果視頻無法直接播放，請確保您的設備支持 MP4 格式，並嘗試使用現代瀏覽器或視頻播放器打開。

✨ 主要特性

• 作業管理（提交、停止、監控）
• 系統信息查詢與檢索
• 與 SeaTunnel 服務的 REST API 交互
• 內置日誌和監控工具
• 動態連接配置
• 全面的作業信息和統計

📦 安裝指南

# 克隆倉庫
git clone <repository_url>
cd seatunnel-mcp

# 創建虛擬環境並安裝
python -m venv .venv
source .venv/bin/activate  # Windows系統請使用：.venv\Scripts\activate
pip install -e .

配置要求

• Python ≥ 3.12
• 運行中的 SeaTunnel 實例
• Node.js（用於與 MCP Inspector 測試）

💻 使用示例

環境變量

SEATUNNEL_API_URL=http://localhost:8090  # 默認的SeaTunnel REST API URL
SEATUNNEL_API_KEY=your_api_key           # 可選：默認的SeaTunnel API密鑰

動態連接配置

服務器提供了查看和更新連接設置的工具：

• get-connection-settings：查看當前連接 URL 和 API 密鑰狀態
• update-connection-settings：更新 URL 和/或 API 密鑰以連接到不同的 SeaTunnel 實例

通過 MCP 示例使用：

// 獲取當前設置
{
  "name": "get-connection-settings"
}

// 更新連接設置
{
  "name": "update-connection-settings",
  "arguments": {
    "url": "http://new-host:8090",
    "api_key": "new-api-key"
  }
}

作業管理

服務器提供了提交和管理 SeaTunnel 作業的工具：

• submit-job：提交一個新的作業，帶有作業配置
• submit-jobs：一次性提交多個作業
• stop-job：停止指定的作業
• monitor-jobs：監控作業狀態

運行服務器

# 在終端中運行以下命令啟動服務器：
python -m seatunnel_mcp_server

與 Claude Desktop 集成

要在 Claude Desktop 中使用 Seatunnel MCP Server，請按照以下步驟配置：

1. 打開 Claude Desktop 的設置。
2. 添加新的 API 端點，URL 為 http://localhost:8090。
3. 在項目中選擇該端點以進行交互。

測試

運行以下命令測試與 MCP 服務器的連接：

curl http://localhost:8090/health

📚 詳細文檔

變更日誌

v1.1.0（最新版本）

• 修復了動態連接配置工具中的一個錯誤，導致無法正確更新 API 密鑰。
• 改進了作業監控功能，現在支持即時更新狀態。

v1.0.1

• 增加了對 JSON 格式作業配置的支持。
• 優化了與 Claude Desktop 的集成體驗。

v1.0.0（初始版本）

• 首次發佈，具備基礎 SeaTunnel 整合能力
• 提供基本的作業管理工具（提交、停止、監控）
• 系統信息查詢工具
• 連接配置實用程序

📄 許可證

Apache License