# opik-mcp

> MCP Server

The Opik MCP Server repository provides a Model Context Protocol implementation for the Opik platform, offering seamless IDE integration and a unified interface through multiple transport mechanisms. The Opik MCP

## Overview

- **Category:** Developer Tools
- **Language:** TypeScript
- **Stars:** 218
- **Forks:** 1
- **Owner:** comet-ml
- **GitHub:** https://github.com/comet-ml/opik-mcp
- **Homepage:** https://www.comet.com/opik/
- **Created:** 2025-03-11T16:31:03+00:00
- **Updated:** 2025-03-26T21:20:47+00:00
- **Source:** https://model-context-protocol.com/servers/opik-model-context-protocol-ide-integration

## Setup

## Setup

**Manual Installation**

1.  Clone the repository:

    ```bash
    git clone https://github.com/comet-ml/opik-mcp.git
    cd opik-mcp
    ```

2.  Install dependencies and build:

    ```bash
    npm install
    npm run build
    ```

**Configuration**

1.  Create a `.env` file based on the example:

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

**Starting the Server**

1.  Start with stdio transport (default):

    ```bash
    npm run start:stdio
    ```

2.  Start with SSE transport for network access (experimental):

    ```bash
    npm run start:sse
    ```

**Cursor Integration**

1.  To integrate with Cursor IDE, create a `.cursor/mcp.json` file in your project directory with the following configuration:

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

2.  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, and replace `YOUR_API_KEY` with your actual Opik API key.

## Tools

## Available Tools

1.  IDE Integration: Seamlessly integrate with Cursor and other compatible IDEs.
2.  Unified API Access: Access all Opik features through a standardized protocol.
3.  Platform Management: Manage prompts, projects, traces, and metrics through a consistent interface.
4.  Prompts Management: Create, list, update, and delete prompts.
5.  Projects/Workspaces Management: Organize and manage projects.
6.  Traces: Track and analyze trace data.
7.  Metrics: Gather and query metrics data.