Opik Mcp Server (Modell Kontextprotokoll)
Modell Kontextprotokoll (MCP) Implementierung für Opik, die nahtlose IDE-Integration und einheitlichen Zugriff auf Eingabeaufforderungen, Projekte, Nachverfolgungen und Metriken ermöglicht.
Übersicht
Was ist Opik-MCP?
Opik-MCP ist eine Implementierung des Model Context Protocol (MCP), die für eine nahtlose Integration mit integrierten Entwicklungsumgebungen (IDEs) entwickelt wurde. Es bietet einen einheitlichen Zugangspunkt zur Verwaltung von Eingabeaufforderungen, Projekten, Nachverfolgungen und Metriken, was den Workflow für Entwickler und Datenwissenschaftler verbessert. Dieses Tool ist besonders nützlich für diejenigen, die ihre maschinellen Lernprozesse optimieren und die Zusammenarbeit in Teams verbessern möchten.
Funktionen von Opik-MCP
- Nahtlose IDE-Integration: Opik-MCP ermöglicht es Benutzern, ihre Entwicklungsumgebung mühelos zu integrieren, was die Verwaltung verschiedener Aspekte von maschinellen Lernprojekten erleichtert.
- Einheitlicher Zugang: Benutzer können Eingabeaufforderungen, Projekte, Nachverfolgungen und Metriken über eine einzige Schnittstelle abrufen, wodurch die Komplexität der Verwaltung mehrerer Tools verringert wird.
- Verbesserte Zusammenarbeit: Das Protokoll erleichtert eine bessere Zusammenarbeit unter Teammitgliedern, indem es eine gemeinsame Plattform für das Projektmanagement bereitstellt.
- Open Source: Als öffentliches Repository ist Opik-MCP offen für Beiträge, sodass Entwickler seine Funktionen und Merkmale erweitern können.
So verwenden Sie Opik-MCP
- Installation: Beginnen Sie damit, das Opik-MCP-Repository von GitHub zu klonen. Verwenden Sie den Befehl:
git clone https://github.com/comet-ml/opik-mcp.git - Einrichtung: Befolgen Sie die Installationsanweisungen in der README-Datei des Repositories, um die Umgebung gemäß Ihren Bedürfnissen zu konfigurieren.
- Integration: Integrieren Sie Opik-MCP mit Ihrer bevorzugten IDE. Detaillierte Anweisungen finden Sie im Dokumentationsbereich des Repositories.
- Nutzung: Beginnen Sie, die Funktionen von Opik-MCP zu nutzen, um Ihre maschinellen Lernprojekte effektiv zu verwalten. Greifen Sie über die einheitliche Schnittstelle auf Eingabeaufforderungen, Projekte, Nachverfolgungen und Metriken zu.
Häufig gestellte Fragen
Welche Programmiersprachen unterstützt Opik-MCP?
Opik-MCP ist so konzipiert, dass es sprachunabhängig ist und mit verschiedenen Programmiersprachen verwendet werden kann, die häufig im maschinellen Lernen eingesetzt werden, wie Python, R und Java.
Ist Opik-MCP kostenlos zu verwenden?
Ja, Opik-MCP ist ein Open-Source-Projekt, das unter der Apache-2.0-Lizenz veröffentlicht wurde, was es kostenlos macht, zu verwenden und zu modifizieren.
Wie kann ich zu Opik-MCP beitragen?
Sie können beitragen, indem Sie das Repository forken, Ihre Änderungen vornehmen und einen Pull-Request einreichen. Beiträge sind willkommen, und Sie können auch Probleme melden oder Funktionen vorschlagen.
Wo finde ich weitere Informationen über Opik-MCP?
Für weitere Details besuchen Sie die offizielle Opik-MCP-Seite oder überprüfen Sie die Dokumentation, die im GitHub-Repository verfügbar ist.
Detail
⚠️ 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.
<br>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
Manual Installation
### Clone the repository
git clone https://github.com/comet-ml/opik-mcp.git
cd opik-mcp
### Install dependencies and build
npm install
npm run build
Configuration
Create a .env file based on the example:
cp .env.example .env
### Edit .env with your specific configuration
Starting the Server
### Start with stdio transport (default)
npm run start:stdio
### Start with SSE transport for network access (experimental)
npm run start:sse
IDE Integration
Cursor Integration
To integrate with Cursor IDE, create a .cursor/mcp.json file in your project directory with the following configuration:
{
"mcpServers": {
"opik": {
"command": "/path/to/node",
"args": [
"/path/to/opik-mcp/build/index.js",
"--apiUrl",
"https://www.comet.com/opik/api",
"--apiKey",
"YOUR_API_KEY",
"--workspace",
"default",
"--debug",
"true"
],
"env": {
"OPIK_API_BASE_URL": "https://www.comet.com/opik/api",
"OPIK_API_KEY": "YOUR_API_KEY",
"OPIK_WORKSPACE_NAME": "default",
}
}
}
}
Replace /path/to/node with the path to your Node.js executable and /path/to/opik-mcp with the path to your opik-mcp installation. Also replace YOUR_API_KEY with your actual Opik API key.
Available Commands
The project includes a Makefile for common operations:
### Display all available commands
make help
### Run tests
make test
### Run transport-specific tests
make test-transport
### Start the server with SSE transport (experimental)
make start-sse
### Start the server with stdio transport
make start-stdio
Transport Options
Standard Input/Output
Ideal for local integration where the client and server run on the same machine.
make start-stdio
Server-Sent Events (SSE)
Enables remote access and multiple simultaneous clients over HTTP. Note that this transport option is experimental.
make start-sse
For detailed information about the SSE transport, see docs/sse-transport.md.
Development
Testing
### Run all tests
npm test
### Run specific test suite
npm test -- tests/transports/sse-transport.test.ts
Pre-commit Hooks
This project uses pre-commit hooks to ensure code quality:
### Run pre-commit checks manually
make precommit
Documentation
- SSE Transport - Details on using the SSE transport
- API Reference - Complete API documentation
- Configuration - Advanced configuration options
- IDE Integration - Integration with Cursor IDE
Citation
If you use this project in your research, please cite it as follows:
Comet ML, Inc, Koc, V., & Boiko, Y. (2025). Opik MCP Server. Github. https://doi.org/10.5281/zenodo.15411156
Or use the following BibTeX entry:
@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.
License
Apache 2.0
Serverkonfiguration
{
"mcpServers": {
"opik-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--comet-ml--opik-mcp--opik-mcp",
"npm run start"
],
"env": {
"OPIK_API_BASE_URL": "opik-api-base-url",
"OPIK_API_KEY": "opik-api-key",
"OPIK_WORKSPACE_NAME": "opik-workspace-name"
}
}
}
}
