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

⚠️ 참고: 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 신청서를 효율적으로 구성하고 모니터링하세요

특징

프롬프트 관리 : 프롬프트 생성, 나열, 업데이트 및 삭제
프로젝트/작업 공간 관리 : 프로젝트를 구성하고 관리합니다.
추적 : 추적 데이터 추적 및 분석
메트릭 : 메트릭 데이터 수집 및 쿼리

빠른 시작

설치

수동 설치

지엑스피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

선적 서류 비치

SSE 전송 - SSE 전송 사용에 대한 세부 정보
API 참조 - 전체 API 문서
구성 - 고급 구성 옵션
IDE 통합 - Cursor IDE와의 통합

특허

아파치 2.0

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

Opik 플랫폼용 모델 컨텍스트 프로토콜 구현으로, Opik 기능에 액세스하기 위한 통합 인터페이스를 제공하고 IDE 및 기타 환경과의 유연한 통합을 위한 여러 전송 메커니즘을 지원합니다.

Related Resources

Reddit Discussion about this server

Appeared in Searches

Exploring the Concept of Multi-Agentic Systems