Servidor Opik MCP

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Used for configuration through environment variables in a .env file
Hosts the repository and provides licensing information
Provides a Makefile for common operations like testing and starting the server

⚠️ Aviso: La compatibilidad con el transporte SSE (Eventos enviados por el servidor) es actualmente experimental y no se ha probado. Para su uso en producción, recomendamos usar el enfoque de ejecución directa de procesos que se muestra en los ejemplos de integración del IDE.

🚀 ¿Qué es Opik MCP Server?

El Servidor MCP de Opik es una implementación de código abierto del Protocolo de Contexto de Modelo para la plataforma Opik. Proporciona una interfaz unificada para interactuar con las capacidades de Opik, compatible con múltiples mecanismos de transporte para una integración flexible en diversos entornos.

Puede utilizar Opik MCP Server para:

Integración IDE:
- Integración perfecta con Cursor y otros IDE compatibles
- Proporcione acceso directo a las capacidades de Opik desde su entorno de desarrollo
Acceso API unificado:
- Acceda a todas las funciones de Opik a través de un protocolo estandarizado
- Aproveche múltiples opciones de transporte (stdio, SSE) para diferentes escenarios de integración
Gestión de la plataforma:
- Administre avisos, proyectos, seguimientos y métricas a través de una interfaz consistente
- Organice y supervise sus solicitudes de LLM de manera eficiente

Características

Gestión de indicaciones : crear, enumerar, actualizar y eliminar indicaciones
Gestión de proyectos/espacios de trabajo : organizar y gestionar proyectos
Rastreos : Rastrear y analizar datos de rastreo
Métricas : recopilar y consultar datos de métricas

Inicio rápido

Instalación

Instalación manual

# 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

Configuración

Cree un archivo .env basado en el ejemplo:

cp .env.example .env
# Edit .env with your specific configuration

Iniciando el servidor

# Start with stdio transport (default)
npm run start:stdio

# Start with SSE transport for network access (experimental)
npm run start:sse

Integración IDE

Integración del cursor

Para integrarse con Cursor IDE, cree un archivo .cursor/mcp.json en el directorio de su proyecto con la siguiente configuración:

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

Reemplaza /path/to/node con la ruta a tu ejecutable de Node.js y /path/to/opik-mcp con la ruta a tu instalación de opik-mcp. También reemplaza YOUR_API_KEY con tu clave API de Opik.

Comandos disponibles

El proyecto incluye un Makefile para operaciones comunes:

# 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

Opciones de transporte

Entrada/Salida estándar

Ideal para la integración local donde el cliente y el servidor se ejecutan en la misma máquina.

make start-stdio

Eventos enviados por el servidor (SSE)

Permite el acceso remoto y la conexión simultánea de varios clientes mediante HTTP. Tenga en cuenta que esta opción de transporte es experimental.

make start-sse

Para obtener información detallada sobre el transporte SSE, consulte docs/sse-transport.md .

Desarrollo

Pruebas

# Run all tests
npm test

# Run specific test suite
npm test -- tests/transports/sse-transport.test.ts

Ganchos de pre-confirmación

Este proyecto utiliza ganchos previos a la confirmación para garantizar la calidad del código:

# Run pre-commit checks manually
make precommit

Documentación

Transporte SSE : detalles sobre el uso del transporte SSE
Referencia de API : documentación completa de la API
Configuración - Opciones de configuración avanzadas
Integración IDE : Integración con Cursor IDE

Licencia

Apache 2.0

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

Una implementación del Protocolo de Contexto de Modelo para la plataforma Opik que proporciona una interfaz unificada para acceder a las capacidades de Opik, admitiendo múltiples mecanismos de transporte para una integración flexible con IDE y otros entornos.

Related Resources

Reddit Discussion about this server

Appeared in Searches

Exploring the Concept of Multi-Agentic Systems