An implementation of the Model Context Protocol for the Opik platform that provides a unified interface for accessing Opik's capabilities, supporting multiple transport mechanisms for flexible integration with IDEs and other environments.
A Model Context Protocol (MCP) implementation for the Opik platform with support for multiple transport mechanisms, enabling seamless integration with IDEs and providing a unified interface for Opik's capabilities.
⚠️ Notice: SSE (Server-Sent Events) transport support is currently experimental and untested. For production use, we recommend using the direct process execution approach shown in the IDE integration examples.
🚀 What is Opik MCP Server?
Opik MCP Server is an open-source implementation of the Model Context Protocol for the Opik platform. It provides a unified interface for interacting with Opik's capabilities, supporting multiple transport mechanisms for flexible integration into various environments.
You can use Opik MCP Server for:
IDE Integration:
Seamlessly integrate with Cursor and other compatible IDEs
Provide direct access to Opik's capabilities from your development environment
Unified API Access:
Access all Opik features through a standardized protocol
Leverage multiple transport options (stdio, SSE) for different integration scenarios
Platform Management:
Manage prompts, projects, traces, and metrics through a consistent interface
Organize and monitor your LLM applications efficiently
Features
Prompts Management: Create, list, update, and delete prompts
Projects/Workspaces Management: Organize and manage projects
Traces: Track and analyze trace data
Metrics: Gather and query metrics data
Quick Start
Installation
Cursor Integration
To integrate with Cursor IDE, open to the Cursor settings page and navigate
to the Features tab. If you scroll down to the MCP section you will see the
button + Add new MCP server that will allow you to add the Opik MCP server.
Once the New MCP server modal is open, select command as the server type and
enter the command: npx -y opik-mcp --apiKey YOUR_API_KEY.
Alternatively, you can create a .cursor/mcp.json in your project and add:
Note: If you are using the Open-Source version of Opik, you will need to specify
the apiBaseUrl parameter as http://localhost:5173/api.
Windsurf Installation
To install the MCP server in Windsurf, you will need to open the Windsurf settings
and navigate to the MCP section. From there, click on View raw config and update
the configuration object to be:
@software{CometML_Opik_MCP_Server_2025,
author = {{Comet ML, Inc} and Koc, V. and Boiko, Y.},
title = {{Opik MCP Server}},
year = {2025},
publisher = {GitHub},
url = {https://doi.org/10.5281/zenodo.15411156},
doi = {10.5281/zenodo.15411156}
}
You can also find citation information in the CITATION.cff file in this repository.
