Skip to content

Conversation

@prassanna-ravishankar
Copy link

@prassanna-ravishankar prassanna-ravishankar commented Jul 13, 2025

Description

This pull request adds a new MCP-compatible server for ClearML, the open-source MLOps platform.

The clearml-mcp server exposes the core functionality of the ClearML SDK as a collection of 14 tools that LLM agents can use. This allows agents to perform a wide range of MLOps tasks, such as:

  • Managing and querying experiments (tasks)
  • Accessing and comparing models
  • Reporting scalars and metrics
  • Interacting with ClearML projects

This integration empowers AI agents to become active participants in the machine learning lifecycle. The server can be found at https://github.com/prass-d/clearml-mcp.

Server Details

  • Server: clearml
  • Changes to: This is a new server submission.

Motivation and Context

The goal is to bridge the gap between large language models and MLOps platforms. By providing a toolset for ClearML, we enable developers to build autonomous agents that can manage ML workflows, automate experiment tracking, and interact with MLOps infrastructure programmatically through natural language or agentic systems.

This solves the problem of needing bespoke scripts and manual intervention for many common MLOps tasks, allowing them to be orchestrated by an LLM.

How Has This Been Tested?

The server has been thoroughly tested:

  • Unit & Integration Tests: The project has a comprehensive test suite with 98% code coverage, ensuring the reliability of all 14 tools. All tests pass locally.
  • LLM Client Testing: The server has been manually tested with an LLM client to validate end-to-end functionality. Scenarios tested include creating tasks, logging metrics, searching for projects, and retrieving model information. A demo.cast in the repository demonstrates a live session.

Breaking Changes

None. This is a new server addition.

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have read the MCP Protocol Documentation
  • My changes follows MCP security best practices
  • I have updated the server's README accordingly
  • I have tested this with an LLM client
  • My code follows the repository's style guidelines
  • New and existing tests pass locally
  • I have added appropriate error handling
  • I have documented all environment variables and configuration options

Additional context

The clearml-mcp server is designed to be lightweight and easy to deploy. It relies on a standard clearml.conf file for authentication, so no special environment variables are needed beyond what a standard ClearML user would have. The project uses uv for dependency management.

@prassanna-ravishankar prassanna-ravishankar changed the title add ClearML MCP to README docs: Add ClearML MCP to README Jul 13, 2025
@olaservo
Copy link
Member

Thanks for your contribution to the servers list. This has been merged in this combined PR: #2370

This is a new process we're trying out, so if you see any issues feel free to re-open the PR and tag me.

@olaservo olaservo closed this Jul 18, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants