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.

Related MCP server: OpenAPI MCP Server

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

Requirements

• Python ≥ 3.12

• Running SeaTunnel instance

• Node.js (for testing with MCP Inspector)

Usage

Environment Variables

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:

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

Usage with Claude Desktop

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

Testing with MCP Inspector

Available Tools

Connection Management

• get-connection-settings: View current SeaTunnel connection URL and API key status

• update-connection-settings: Update URL and/or API key to connect to a different instance

Job Management

• submit-job: Submit a new job with configuration in HOCON format

• submit-job/upload: submit job source upload configuration file

• submit-jobs: Submit multiple jobs in batch, directly passing user input as request body

• stop-job: Stop a running job with optional savepoint

• get-job-info: Get detailed information about a specific job

• get-running-jobs: List all currently running jobs

• get-running-job: Get details about a specific running job

• get-finished-jobs: List all finished jobs by state

System Monitoring

• get-overview: Get an overview of the SeaTunnel cluster

• get-system-monitoring-information: Get detailed system monitoring information

Changelog

v1.2.0 (2025-06-10)

New Features in v1.2.0

• SSE Support: Added st-mcp-sse for real-time communication with SeaTunnel MCP via Server-Sent Events (SSE). Corresponding sse branch

• UV/Studio Mode: Added st-mcp-uv (or st-mcp-studio) to support running the MCP server using the uv tool for improved performance and async support. Corresponding to uv branch

Example claude_desktop_config.json:

v1.1.0 (2025-04-10)

• New Feature: Added submit-jobs and submit-job/upload tool for batch job submission and Document submission operations

  • Allows submitting multiple jobs at once with a single API call

  • Input is passed directly as the request body to the API

  • Supports JSON format for job configurations

  • Allow submission of jobs based on documents

v1.0.0 (Initial Release)

• Initial release with basic SeaTunnel integration capabilities

• Job management tools (submit, stop, monitor)

• System monitoring tools

• Connection configuration utilities

License

Apache License