Back to Browse

Apache Flink MCP Server

Developer ToolsUse Caution3.5MCP RegistryLocal
Free

Server data from the Official MCP Registry

MCP server for monitoring Apache Flink clusters via natural language, multi-cluster support.

About

MCP server for monitoring Apache Flink clusters via natural language, multi-cluster support.

Security Report

3.5
Use Caution3.5High Risk

The visible Flink monitoring tools are read-only GET requests to a user-supplied Flink REST URL, with no authentication support and no URL allowlist, so the server will contact any host it is pointed at. The README advertises a send_mail tool, but its implementation is truncated and unverifiable, and it adds an outbound data channel that could leak cluster data; the unusual 'secure-smtplib' dependency also needs review. Score is held below 7.0 by these unresolved items. Supply chain analysis found 6 known vulnerabilities in dependencies (1 critical, 3 high severity).

3 files analyzed ยท 12 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

network_smtp

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

How to Install

Install command not verified. See the repository for install instructions.

View repository

Documentation

View on GitHub

From the project's GitHub README.

Apache Flink MCP Server

Glama MCP Server

A Model Context Protocol (MCP) server implementation for Apache Flink that enables AI assistants and large language models to interact with Flink clusters through natural language interfaces. This server provides comprehensive tools for monitoring, managing, and analyzing Apache Flink streaming applications.

This project is tested with BrowserStack

alt text

Overview

The Apache Flink MCP Server bridges the gap between AI assistants and Apache Flink clusters by providing a standardized MCP interface. It allows users to perform complex Flink operations through conversational AI, making stream processing management more accessible and intuitive.

Features

๐ŸŽฏ Core Capabilities

  • Cluster Monitoring: Get real-time cluster information including jobs, slots, and TaskManagers
  • Job Management: List, monitor, and analyze Flink job details and metrics
  • Exception Tracking: Retrieve and analyze job exceptions for debugging
  • Resource Management: Monitor TaskManager resources and JAR file deployments
  • Metrics Collection: Access comprehensive job and cluster metrics

๐Ÿ”ง Available Tools:

  1. initialize_flink_connection โ€“ Connect to Flink REST API
  2. get_connection_status โ€“ Check connection status
  3. get_cluster_info โ€“ Overview of the Flink cluster
  4. list_jobs โ€“ List all Flink jobs with status
  5. get_job_details โ€“ Comprehensive job details by ID
  6. get_job_exceptions โ€“ Fetch job-level exceptions
  7. get_job_metrics โ€“ Fetch metrics for a job
  8. list_taskmanagers โ€“ List TaskManagers with resources
  9. list_jar_files โ€“ List uploaded JAR files
  10. send mail โ€“ (Send an email notification)

๐Ÿ”€ Multiple Flink clusters

initialize_flink_connection and get_connection_status take an optional connection name (defaults to "default"). Every other tool also takes an optional connection argument, so you can register more than one Flink app/cluster and target them independently in the same server process:

initialize_flink_connection(flink_url="http://localhost:8081", connection="orders-pipeline")
initialize_flink_connection(flink_url="http://localhost:8091", connection="clickstream-pipeline")

get_cluster_info(connection="orders-pipeline")
list_jobs(connection="clickstream-pipeline")

Omitting connection keeps working exactly as before, against the single "default" connection.


๐Ÿš€ Benefits

  • Natural Language Interface: Interact with Flink using conversational AI
  • Real-time Monitoring: Get instant insights into cluster and job status
  • Debugging Support: Easily access exception logs and metrics
  • Resource Optimization: Monitor resource usage across TaskManagers
  • Developer Productivity: Reduce time spent navigating Flink Web UI

Installation

Prerequisites

  • Apache Flink cluster (running and accessible)
  • Python 3.8 or higher
  • MCP-compatible client (Claude Desktop, Continue etc.)

Client Configuration

Continue.dev

Add to your Continue configuration (Flink-mcp-server.yaml):

name: Sample MCP
version: 0.0.1
schema: v1
mcpServers:
  - name: Flink MCP Server
    type: streamable-http
    url:   http://127.0.0.1:9090/mcp/ 

Usage Examples

Basic Cluster Monitoring

Human: What's the status of my Flink cluster?
AI: I'll check your Flink cluster status for you.
[Uses get_cluster_info tool to fetch cluster overview]

Job Analysis

Human: Show me all running jobs and their performance metrics
AI: Let me get the current jobs and their metrics.
[Uses list_jobs and get_job_metrics tools]

Troubleshooting

Human: My job with ID abc123 is failing. Can you help me debug it?
AI: I'll check the job details and any exceptions for job abc123.
[Uses get_job_details and get_job_exceptions tools]

Resource Management

Human: How are my TaskManager resources being utilized?
AI: Let me check your TaskManager status and resource allocation.
[Uses list_taskmanagers tool]

API Reference

Available MCP Tools

get_cluster_info

Description: Fetch an overview of the Flink cluster including jobs, slots, and TaskManagers. Parameters: None Returns: Cluster overview with resource information

list_jobs

Description: List all current and recent Flink jobs with their status. Parameters: None Returns: List of jobs with status, start time, and duration

get_job_details

Description: Get detailed information about a specific Flink job. Parameters:

  • job_id (string, required): The unique identifier of the Flink job
list_taskmanagers

Description: List all registered TaskManagers in the cluster. Parameters: None Returns: List of TaskManagers with resource information

get_job_exceptions

Description: Fetch exceptions that occurred in the specified job. Parameters:

  • job_id (string, required): The unique identifier of the Flink job
list_jar_files

Description: List all uploaded JAR files in the Flink cluster. Parameters: None Returns: List of available JAR files

get_job_metrics

Description: Fetch selected useful metrics for a running Flink job. Parameters:

  • job_id (string, required): The unique identifier of the Flink job

send_mail

Description: Send an email notification, such as alerts, status updates, or reports from the Flink MCP server.

Troubleshooting

Common Issues

Connection Failed

  • Verify Flink cluster is running and accessible
  • Ensure network connectivity to Flink JobManager

Permission Errors

  • Verify Flink REST API is enabled
  • Check if authentication is required for your Flink setup

Debug Mode

Enable detailed logging:

export LOG_LEVEL=DEBUG
python mcp_server.py

Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature-name
  3. Make your changes and add tests
  4. Commit your changes: git commit -m "Add feature"
  5. Push to your fork: git push origin feature-name
  6. Create a Pull Request

Development Guidelines

  • Follow PEP 8 style guidelines
  • Update documentation as needed
  • Ensure backward compatibility

License

This project is licensed under the MIT License.

Related Projects

Support

Acknowledgments

  • Apache Flink community for the excellent stream processing framework
  • Model Context Protocol team for the standardized interface
  • Contributors and users of this project

Note: This MCP server provides read-only access to Flink cluster information by default. For write operations, additional configuration and security considerations may be required.

Reviews

No reviews yet

Be the first to review this server!