opik-mcp : un MCP open-source pour la plateforme Opik, prenant en charge plusieurs mécanismes de transport et l'intégration aux IDE 163

Qu'est-ce qu'opik-MCP ?

opik-mcp est un projet MCP de modèle open-source implémenté pour la plateforme Opik. Il prend en charge plusieurs mécanismes de transport et peut être intégré de manière transparente dans un IDE, fournissant une interface unifiée pour accéder aux fonctionnalités d'Opik. Il facilite la gestion des prompts, des projets, des données de traçage et des métriques, afin d'organiser et de surveiller efficacement les applications basées sur de grands modèles de langage.

Fonctionnalités d'opik-mcp

• Interface unifiée : fournit une interface API standardisée, permettant aux développeurs d'accéder directement aux fonctionnalités d'Opik depuis leur environnement de développement.

• Prise en charge de plusieurs mécanismes de transport : prend en charge deux mécanismes de transport, à savoir l'entrée/sortie standard (stdio) et les événements envoyés par le serveur (SSE). La prise en charge de SSE est encore expérimentale à ce stade ; il est recommandé d'utiliser stdio en environnement de production.

• Intégration à l'environnement de développement (IDE) : peut être intégré de manière transparente dans des IDE compatibles tels que Cursor.

• Gestion des projets et des prompts :

• Prend en charge la création, le listage, la mise à jour et la suppression des prompts.

• Permet d'organiser et de gérer les projets ainsi que les espaces de travail.

• Traçage et analyse :

• Trace et analyse les données de traçage (traces) des applications, aidant les développeurs à mieux comprendre le comportement de l'application.

• Collecte et interroge les données de métriques de performance, utilisées pour surveiller les performances de l'application.

Installation et utilisation d'opik-mcp

Installation :

Node.js v20.11.0 ou une version ultérieure est requis.

Clonez le dépôt et installez les dépendances :

git clone https://github.com/comet-ml/opik-mcp.git
cd opik-mcp
npm install
npm run build

Configuration :

Créez un fichier .env et modifiez la configuration selon vos besoins, par exemple en définissant l'URL de base de l'API et la clé d'API.

La configuration peut être effectuée via des arguments en ligne de commande ou des variables d'environnement.

Démarrage du serveur :

En utilisant le transport stdio (par défaut) :

npm run start:stdio

En utilisant le transport SSE (expérimental) :

npm run start:sse

Intégration à l'IDE

Prenons l'exemple de Cursor IDE, l'intégration peut être réalisée en suivant les étapes ci-dessous :

Créez un fichier .cursor/mcp.json dans le répertoire du projet et configurez-le avec le contenu suivant :

{
"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"
  }
}
}
}

Où /path/to/node et /path/to/opik-mcp doivent être remplacés par le chemin réel de l'exécutable Node.js et par le chemin d'installation d'Opik MCP, et YOUR_API_KEY doit être remplacé par votre clé d'API Opik.

Vous pouvez également ajouter manuellement le serveur Opik MCP via la page des paramètres de Cursor.

Cas d'utilisation d'opik-mcp

• Intégration à l'environnement de développement : grâce à l'intégration à l'IDE, les développeurs peuvent utiliser directement les fonctionnalités d'Opik pendant le processus de développement.

• Gestion des applications : gestion des indicateurs de performance, des données de traçage et des prompts des applications LLM.

• Débogage et optimisation : analyse des données de télémétrie de l'application, facilitant le débogage et l'optimisation.

• Le serveur Opik MCP offre des options de déploiement flexibles et des fonctionnalités puissantes ; c'est un outil performant pour le développement et la gestion d'applications LLM.

Page officielle du projet : http://www.comet.com/opik/

Github : https://github.com/comet-ml/opik-mcp