A Model Context Protocol (MCP) 서버는 Claude와 같은 LLM 인터페이스를 통해 SeaTunnel과 상호 작용합니다.

가동 영상

SeaTunnel MCP의 기능과 사용법을 잘 이해하기 위해 비디오 데모를 제공합니다. 아래 링크를 참조하거나 프로젝트 문서 디렉토리의 비디오 파일을 직접 확인하십시오.

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

팁: 비디오가 직접 재생되지 않는 경우 장치가 MP4 형식을 지원하고 현대 브라우저 또는 비디오 플레이어를 열어보십시오.

특징

• 작업 관리 (submit, 스톱, 모니터)
• 시스템 모니터링 및 정보 검색
• SeaTunnel 서비스의 REST API 상호 작용
• 내장 로깅 및 모니터링 도구
• 동적 연결 구성
• 종합 업무 정보 및 통계

설치

요구 사항

• 파이썬 ≥ 3.12
• SeaTunnel 인스턴스 실행
• Node.js (MCP Inspector 테스트용)

사용법

환경 변수

동적 연결 구성

서버는 runtime에 연결 설정을 보고 업데이트하는 도구를 제공합니다:

• get-connection-settings: 현재 연결 URL 및 API 키 상태 보기

SeaTunnel MCP Server

A Model Context Protocol (MCP) server for interacting with SeaTunnel through LLM interfaces like Claude.

Operation Video

To help you better understand the features and usage of SeaTunnel MCP, we provide a video demonstration. Please refer to the link below or directly check the video file in the project documentation directory.

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

Tip: If the video does not play directly, make sure your device supports MP4 format and try opening it with a modern browser or video player.

Features

• Job management (submit, stop, monitor)
• System monitoring and information retrieval
• REST API interaction with SeaTunnel services
• Built-in logging and monitoring tools
• Dynamic connection configuration
• Comprehensive job information and statistics

Installation

# Clone repository
git clone 
cd seatunnel-mcp

# Create virtual environment and install
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e .

Requirements

• Python ≥ 3.12
• Running SeaTunnel instance
• Node.js (for testing with MCP Inspector)

Usage

Environment Variables

SEATUNNEL_API_URL=http://localhost:8090  # Default SeaTunnel REST API URL
SEATUNNEL_API_KEY=your_api_key           # Optional: Default SeaTunnel API key

Dynamic Connection Configuration

The server provides tools to view and update connection settings at runtime:

• get-connection-settings: View current connection URL and API key status
• update-connection-settings: Update URL and/or API key to connect to a different SeaTunnel instance

Example usage through MCP:

// Get current settings
{
  "name": "get-connection-settings"
}

// Update connection settings
{
  "name": "update-connection-settings",
  "arguments": {
    "url": "http://new-host:8090",
    "api_key": "new-api-key"
  }
}

Job Management

The server provides tools to submit and manage SeaTunnel jobs:

• submit-job: Submit a new job with job configuration
• submit-jobs: Submit multiple jobs in batch
• stop-job: Stop a running job
• get-job-info: Get detailed information about a specific job
• get-running-jobs: List all currently running jobs
• get-finished-jobs: List all finished jobs by state (FINISHED, CANCELED, FAILED, etc.)

Running the Server

python -m src.seatunnel_mcp

Usage with Claude Desktop

To use this with Claude Desktop, add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "seatunnel": {
      "command": "python",
      "args": ["-m", "src.seatunnel_mcp"],
      "cwd": "Project root directory"
    }
  }
}

Testing with MCP Inspector