SeaTunnel MCP Server

by ocean-zhc
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Integrates with SeaTunnel (an Apache project) to provide job management capabilities including submitting, stopping, and monitoring jobs, as well as retrieving system monitoring information and cluster overview.

SeaTunnel MCP 서버

Claude와 같은 LLM 인터페이스를 통해 SeaTunnel과 상호 작용하기 위한 MCP(모델 컨텍스트 프로토콜) 서버입니다.

작업 영상

SeaTunnel MCP의 기능과 사용법을 더 잘 이해하실 수 있도록 비디오 데모를 제공합니다. 아래 링크를 참조하시거나 프로젝트 문서 디렉터리에서 비디오 파일을 직접 확인해 주세요.

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

: 비디오가 바로 재생되지 않을 경우, 기기가 MP4 형식을 지원하는지 확인하고 최신 브라우저나 비디오 플레이어로 열어보세요.

특징

  • 작업 관리(제출, 중지, 모니터링)
  • 시스템 모니터링 및 정보 검색
  • SeaTunnel 서비스와의 REST API 상호 작용
  • 내장된 로깅 및 모니터링 도구
  • 동적 연결 구성
  • 포괄적인 직업 정보 및 통계

설치

지엑스피1

요구 사항

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

용법

환경 변수

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

동적 연결 구성

서버는 런타임에 연결 설정을 보고 업데이트할 수 있는 도구를 제공합니다.

  • get-connection-settings : 현재 연결 URL 및 API 키 상태 보기
  • update-connection-settings : 다른 SeaTunnel 인스턴스에 연결하기 위해 URL 및/또는 API 키를 업데이트합니다.

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" } }

작업 관리

이 서버는 SeaTunnel 작업을 제출하고 관리하는 도구를 제공합니다.

  • submit-job : 작업 구성을 사용하여 새 작업 제출
  • submit-jobs : 여러 작업을 일괄적으로 제출합니다.
  • stop-job : 실행 중인 작업을 중지합니다.
  • get-job-info : 특정 직업에 대한 자세한 정보를 얻습니다.
  • get-running-jobs : 현재 실행 중인 모든 작업 나열
  • get-finished-jobs : 완료된 모든 작업을 상태별로 나열합니다(완료, 취소, 실패 등).

서버 실행

python -m src.seatunnel_mcp

Claude Desktop과 함께 사용

Claude Desktop과 함께 사용하려면 claude_desktop_config.json 에 다음을 추가하세요.

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

MCP Inspector로 테스트

npx @modelcontextprotocol/inspector python -m src.seatunnel_mcp

사용 가능한 도구

연결 관리

  • get-connection-settings : 현재 SeaTunnel 연결 URL 및 API 키 상태 보기
  • update-connection-settings : 다른 인스턴스에 연결하기 위해 URL 및/또는 API 키를 업데이트합니다.

작업 관리

  • submit-job : HOCON 형식으로 구성을 변경하여 새 작업을 제출합니다.
  • submit-job/upload : 작업 소스 업로드 구성 파일 제출
  • submit-jobs : 여러 작업을 일괄적으로 제출하고 사용자 입력을 요청 본문으로 직접 전달합니다.
  • stop-job : 선택적 저장점을 사용하여 실행 중인 작업을 중지합니다.
  • get-job-info : 특정 직업에 대한 자세한 정보를 얻습니다.
  • get-running-jobs : 현재 실행 중인 모든 작업 나열
  • get-running-job : 특정 실행 중인 작업에 대한 세부 정보를 가져옵니다.
  • get-finished-jobs : 주별로 완료된 모든 작업 나열

시스템 모니터링

  • get-overview : SeaTunnel 클러스터에 대한 개요를 가져옵니다.
  • get-system-monitoring-information : 자세한 시스템 모니터링 정보를 가져옵니다.

변경 사항

v1.1.0 (2025년 4월 10일)

  • 새로운 기능 : 일괄 submit-jobs 및 문서 제출 작업을 위한 submit-job/upload 도구가 추가되었습니다.
    • 단일 API 호출로 여러 작업을 동시에 제출할 수 있습니다.
    • 입력은 요청 본문으로 API에 직접 전달됩니다.
    • 작업 구성을 위한 JSON 형식 지원
    • 문서 기반 작업 제출 허용

v1.0.0 (최초 릴리스)

  • 기본 SeaTunnel 통합 기능을 갖춘 초기 릴리스
  • 작업 관리 도구(제출, 중지, 모니터링)
  • 시스템 모니터링 도구
  • 연결 구성 유틸리티

특허

아파치 라이선스

-
security - not tested
A
license - permissive license
-
quality - not tested

LLM 인터페이스를 통해 Apache SeaTunnel과 상호작용을 가능하게 하는 모델 컨텍스트 프로토콜 서버로, 이를 통해 사용자는 작업을 관리하고, 시스템 정보를 모니터링하고, 자연어를 통해 연결을 구성할 수 있습니다.

  1. Operation Video
    1. Features
      1. Installation
        1. Requirements
          1. Usage
            1. Environment Variables
            2. Dynamic Connection Configuration
            3. Job Management
            4. Running the Server
            5. Usage with Claude Desktop
            6. Testing with MCP Inspector
          2. Available Tools
            1. Connection Management
            2. Job Management
            3. System Monitoring
          3. Changelog
            1. v1.1.0 (2025-04-10)
            2. v1.0.0 (Initial Release)
          4. License
            ID: 5ksdj0wcva