opik-mcp: un MCP de código abierto para la plataforma Opik con múltiples mecanismos de transporte e integración con IDE 165

¿Qué es opik-MCP?

opik-mcp es un proyecto de modelo MCP de código abierto implementado para la plataforma Opik. Admite múltiples mecanismos de transporte, puede integrarse sin problemas en IDEs y ofrece una interfaz unificada para acceder a las funcionalidades de Opik, lo que facilita la gestión de prompts, proyectos, datos de seguimiento y métricas, con el fin de organizar y monitorizar eficientemente las aplicaciones de modelos de lenguaje de gran tamaño.

Características de opik-mcp

• Interfaz unificada: ofrece una interfaz API estandarizada que permite a los desarrolladores acceder directamente a las funcionalidades de Opik desde el entorno de desarrollo.

• Soporte de múltiples mecanismos de transporte: admite dos mecanismos de transporte, la entrada/salida estándar (stdio) y los eventos enviados por el servidor (SSE). Actualmente, el soporte para SSE sigue siendo experimental; se recomienda utilizar stdio en entornos de producción.

• Entorno de desarrollo integrado (IDE): puede integrarse sin problemas en IDEs compatibles como Cursor.

• Gestión de proyectos y prompts:

• Permite crear, listar, actualizar y eliminar prompts.

• Permite organizar y gestionar proyectos y espacios de trabajo.

• Seguimiento y análisis:

• Realiza el seguimiento y análisis de los datos de seguimiento (traces) de la aplicación, ayudando a los desarrolladores a comprender mejor el comportamiento de la aplicación.

• Recopila y consulta datos de métricas de rendimiento (metrics) para monitorizar el rendimiento de la aplicación.

Instalación y uso de opik-mcp

Instalación:

Se requiere Node.js v20.11.0 o una versión superior.

Clona el repositorio e instala las dependencias:

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

Configuración:

Crea un archivo .env y edita la configuración según sea necesario, por ejemplo, para establecer la URL base de la API y la clave de la API.

Puedes configurar mediante argumentos de línea de comandos o variables de entorno.

Iniciar el servidor:

Usando el transporte stdio (por defecto):

npm run start:stdio

Usando el transporte SSE (experimental):

npm run start:sse

Integración con el IDE

Tomando como ejemplo el IDE Cursor, la integración se puede realizar siguiendo estos pasos:

Crea el archivo .cursor/mcp.json en el directorio del proyecto y configúralo con el siguiente contenido:

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

Donde /path/to/node y /path/to/opik-mcp deben sustituirse por la ruta real del ejecutable de Node.js y la ruta de instalación de Opik MCP, y YOUR_API_KEY por tu clave de API de Opik.

También puedes añadir manualmente el Opik MCP Server a través de la página de configuración de Cursor.

Casos de uso de opik-mcp

• Integración en el entorno de desarrollo: mediante la integración con el IDE, los desarrolladores pueden utilizar directamente las funcionalidades de Opik durante el proceso de desarrollo.

• Gestión de aplicaciones: gestiona métricas de rendimiento, datos de seguimiento y prompts de las aplicaciones LLM.

• Depuración y optimización: analiza los datos de telemetría de la aplicación para ayudar en la depuración y optimización.

• Opik MCP Server ofrece opciones de implementación flexibles y potentes funcionalidades, siendo una valiosa herramienta para desarrollar y gestionar aplicaciones LLM.

Página del proyecto: http://www.comet.com/opik/

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