👁 특허
👁 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: OpenAI MCP Server

특징

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

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

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

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

빠른 시작

설치

수동 설치

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

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• create-projectC
• create-promptC
• create-prompt-versionC
• delete-projectC
• delete-promptC
• get-metricsC
• get-opik-examplesC
• get-opik-helpB