Skip to main content
Glama
Opik MCP Server

Opik MCP Server

by comet-ml

특허 Node.js 버전 타입스크립트

⚠️ 참고: SSE(Server-Sent Events) 전송 지원은 현재 실험 단계이며 테스트되지 않았습니다. 프로덕션 환경에서는 IDE 통합 예시에 나와 있는 직접 프로세스 실행 방식을 사용하는 것이 좋습니다.

🚀 Opik MCP 서버란 무엇인가요?

Opik MCP 서버는 Opik 플랫폼을 위한 모델 컨텍스트 프로토콜(Model Context Protocol)의 오픈 소스 구현입니다. Opik의 기능과 상호 작용하기 위한 통합 인터페이스를 제공하며, 다양한 환경에 유연하게 통합할 수 있도록 여러 전송 메커니즘을 지원합니다.

Opik MCP 서버는 다음 용도로 사용할 수 있습니다.

  • IDE 통합:

    • Cursor 및 기타 호환 IDE와 원활하게 통합

    • 개발 환경에서 Opik 기능에 직접 액세스 제공

  • 통합 API 액세스:

    • 표준화된 프로토콜을 통해 모든 Opik 기능에 액세스하세요

    • 다양한 통합 시나리오에 대해 여러 전송 옵션(stdio, SSE)을 활용합니다.

  • 플랫폼 관리:

    • 일관된 인터페이스를 통해 프롬프트, 프로젝트, 추적 및 메트릭을 관리합니다.

    • LLM 신청서를 효율적으로 구성하고 모니터링하세요

Related MCP server: dap-mcp

특징

  • 프롬프트 관리 : 프롬프트 생성, 나열, 업데이트 및 삭제

  • 프로젝트/작업 공간 관리 : 프로젝트를 구성하고 관리합니다.

  • 추적 : 추적 데이터 추적 및 분석

  • 메트릭 : 메트릭 데이터 수집 및 쿼리

빠른 시작

설치

수동 설치

지엑스피1

구성

다음 예를 기반으로 .env 파일을 만듭니다.

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

서버 시작

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

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

IDE 통합

커서 통합

Cursor IDE와 통합하려면 다음 구성으로 프로젝트 디렉토리에 .cursor/mcp.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",
      }
    }
  }
}

/path/to/node Node.js 실행 파일 경로로, /path/to/opik-mcp opik-mcp 설치 경로로 바꾸세요. 또한 YOUR_API_KEY 실제 Opik API 키로 바꾸세요.

사용 가능한 명령

이 프로젝트에는 일반적인 작업을 위한 Makefile이 포함되어 있습니다.

# 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

운송 옵션

표준 입력/출력

클라이언트와 서버가 동일한 머신에서 실행되는 로컬 통합에 이상적입니다.

make start-stdio

서버 전송 이벤트(SSE)

HTTP를 통해 원격 액세스와 여러 클라이언트 동시 접속을 지원합니다. 이 전송 옵션은 아직 실험 단계입니다.

make start-sse

SSE 전송에 대한 자세한 내용은 docs/sse-transport.md를 참조하세요.

개발

테스트

# Run all tests
npm test

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

사전 커밋 후크

이 프로젝트에서는 코드 품질을 보장하기 위해 사전 커밋 후크를 사용합니다.

# Run pre-commit checks manually
make precommit

선적 서류 비치

특허

아파치 2.0

Available Tools

19 tools
create-projectCInspect

Create a new project/workspace

Inputs: name (required), description, workspaceName.

create-promptCInspect

Create a new prompt

Inputs: name (required).

create-prompt-versionCInspect

Create a new version of a prompt

Inputs: commit_message (required), name (required), template (required).

delete-projectCInspect

Delete a project

Inputs: projectId (required), workspaceName.

delete-promptCInspect

Delete a prompt

Inputs: promptId (required).

get-metricsCInspect

Get metrics data

Inputs: endDate, metricName, projectId, projectName, +1 more.

get-opik-examplesCInspect

Get examples of how to use Opik Comet's API for specific tasks

Inputs: task (required).

get-opik-helpBInspect

Get contextual help about Opik Comet's capabilities

Inputs: topic (required), subtopic.

get-opik-tracing-infoCInspect

Get information about Opik's tracing capabilities and how to use them

Inputs: topic.

get-project-by-idCInspect

Get a single project by ID

Inputs: projectId (required), workspaceName.

get-prompt-by-idCInspect

Get a single prompt by ID

Inputs: promptId (required).

get-server-infoBInspect

Get information about the Opik server configuration

Inputs: random_string.

get-trace-by-idCInspect

Get a single trace by ID

Inputs: traceId (required), workspaceName.

get-trace-statsCInspect

Get statistics for traces

Inputs: endDate, projectId, projectName, startDate, +1 more.

list-projectsCInspect

Get a list of projects/workspaces

Inputs: page (required), size (required), sortBy, sortOrder, +1 more.

list-promptsCInspect

Get a list of Opik prompts

Inputs: page (required), size (required).

list-tracesCInspect

Get a list of traces

Inputs: page (required), size (required), projectId, projectName, +1 more.

update-projectCInspect

Update a project

Inputs: projectId (required), description, name, workspaceName.

update-promptCInspect

Update a prompt

Inputs: name (required), promptId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 19 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific resources (projects, prompts, traces, metrics, help) and actions (create, get, list, update, delete). There is no overlap or ambiguity between tools, making it easy for an agent to select the right one for any operation.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with hyphens (e.g., create-project, get-project-by-id, list-projects). The naming is uniform across all 19 tools, using clear verbs like create, get, list, update, and delete paired with specific nouns.

    Tool Count4/5

    With 19 tools, the count is slightly high but reasonable for a comprehensive server covering projects, prompts, traces, metrics, and help. It feels well-scoped for the Opik domain, though it borders on being heavy compared to typical 3-15 tool ranges.

    Completeness5/5

    The tool set provides complete CRUD/lifecycle coverage for projects and prompts (create, get, list, update, delete), with additional tools for traces, metrics, and help. There are no obvious gaps; agents can perform all core operations without dead ends in this domain.

    Maintenance

    ActivityActive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      Implements the Model Context Protocol (MCP) to provide AI models with a standardized interface for connecting to external data sources and tools like file systems, databases, or APIs.
      1
      153
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An implementation of the Model Context Protocol (MCP) that enables interaction with debug adapters, allowing language models to control debuggers, set breakpoints, evaluate expressions, and navigate source code during debugging sessions.
      41
      AGPL 3.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Python-based implementation of the Model Context Protocol that enables communication between a model context management server and client through a request-response architecture.
      -
    • -
      license
      Not graded
      quality
      D
      maintenance
      A standardized foundation for building Model Context Protocol servers that integrate with VS Code, using Python with stdio transport for seamless AI tool integration.
      -