Opik Mcp Serveur (modèle Protocole de Contexte)
Mise en œuvre du Protocole de Contexte de Modèle (MCP) pour Opik permettant une intégration fluide de l'IDE et un accès unifié aux invites, projets, traces et métriques.
Aperçu
Qu'est-ce qu'Opik-MCP ?
Opik-MCP est une implémentation du Model Context Protocol (MCP) conçue pour une intégration transparente avec les environnements de développement intégrés (IDE). Il fournit un point d'accès unifié pour gérer les invites, les projets, les traces et les métriques, améliorant ainsi le flux de travail des développeurs et des scientifiques des données. Cet outil est particulièrement utile pour ceux qui souhaitent rationaliser leurs processus d'apprentissage automatique et améliorer la collaboration au sein des équipes.
Fonctionnalités d'Opik-MCP
- Intégration transparente avec l'IDE : Opik-MCP permet aux utilisateurs d'intégrer leur environnement de développement sans effort, facilitant ainsi la gestion de divers aspects des projets d'apprentissage automatique.
- Accès unifié : Les utilisateurs peuvent accéder aux invites, projets, traces et métriques à partir d'une seule interface, réduisant la complexité de la gestion de plusieurs outils.
- Collaboration améliorée : Le protocole facilite une meilleure collaboration entre les membres de l'équipe en fournissant une plateforme partagée pour la gestion de projet.
- Open Source : Étant un dépôt public, Opik-MCP est ouvert aux contributions, permettant aux développeurs d'améliorer ses fonctionnalités.
Comment utiliser Opik-MCP
- Installation : Commencez par cloner le dépôt Opik-MCP depuis GitHub. Utilisez la commande :
git clone https://github.com/comet-ml/opik-mcp.git
- Configuration : Suivez les instructions de configuration fournies dans le fichier README du dépôt pour configurer l'environnement selon vos besoins.
- Intégration : Intégrez Opik-MCP avec votre IDE préféré. Des instructions détaillées peuvent être trouvées dans la section documentation du dépôt.
- Utilisation : Commencez à utiliser les fonctionnalités d'Opik-MCP pour gérer efficacement vos projets d'apprentissage automatique. Accédez aux invites, projets, traces et métriques via l'interface unifiée.
Questions Fréquemment Posées
Quels langages de programmation Opik-MCP prend-il en charge ?
Opik-MCP est conçu pour être indépendant du langage, ce qui permet de l'utiliser avec divers langages de programmation couramment utilisés en apprentissage automatique, tels que Python, R et Java.
Opik-MCP est-il gratuit à utiliser ?
Oui, Opik-MCP est un projet open-source publié sous la licence Apache-2.0, ce qui le rend gratuit à utiliser et à modifier.
Comment puis-je contribuer à Opik-MCP ?
Vous pouvez contribuer en forkant le dépôt, en apportant vos modifications et en soumettant une demande de tirage. Les contributions sont les bienvenues, et vous pouvez également signaler des problèmes ou suggérer des fonctionnalités.
Où puis-je trouver plus d'informations sur Opik-MCP ?
Pour plus de détails, visitez la page officielle d'Opik-MCP ou consultez la documentation disponible dans le dépôt GitHub.
Détail
<img src="https://badge.mcpx.dev?status=on" title="MCP Enabled"/>
⚠️ 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
Configuration du serveur
{
"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"
}
}
}
}