SeaTunnel MCP 서버
Claude와 같은 LLM 인터페이스를 통해 SeaTunnel과 상호 작용하기 위한 MCP(모델 컨텍스트 프로토콜) 서버입니다.
작업 영상
SeaTunnel MCP의 기능과 사용법을 더 잘 이해하실 수 있도록 비디오 데모를 제공합니다. 아래 링크를 참조하시거나 프로젝트 문서 디렉터리에서 비디오 파일을 직접 확인해 주세요.
https://www.youtube.com/watch?v=JaLA8EkZD7Q
팁 : 비디오가 바로 재생되지 않을 경우, 기기가 MP4 형식을 지원하는지 확인하고 최신 브라우저나 비디오 플레이어로 열어보세요.
Related MCP server: OpenAPI MCP Server
특징
작업 관리(제출, 중지, 모니터링)
시스템 모니터링 및 정보 검색
SeaTunnel 서비스와의 REST API 상호 작용
내장된 로깅 및 모니터링 도구
동적 연결 구성
포괄적인 직업 정보 및 통계
설치
지엑스피1
요구 사항
파이썬 ≥ 3.12
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_mcpClaude 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 통합 기능을 갖춘 초기 릴리스
작업 관리 도구(제출, 중지, 모니터링)
시스템 모니터링 도구
연결 구성 유틸리티
특허
아파치 라이선스