Opik MCP Server

Official

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 アプリケーションを効率的に整理および監視します

特徴

  • プロンプト管理: プロンプトの作成、一覧表示、更新、削除
  • プロジェクト/ワークスペース管理: プロジェクトの整理と管理
  • トレース: トレースデータを追跡および分析する
  • メトリクス: メトリクスデータを収集してクエリする

クイックスタート

インストール

手動インストール

# 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

構成

例に基づいて.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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Opik プラットフォーム用のモデル コンテキスト プロトコルの実装。Opik の機能にアクセスするための統一されたインターフェイスを提供し、IDE やその他の環境との柔軟な統合を可能にする複数のトランスポート メカニズムをサポートします。

  1. Features
    1. Quick Start
      1. Installation
      2. Configuration
      3. Starting the Server
    2. IDE Integration
      1. Cursor Integration
    3. Available Commands
      1. Transport Options
        1. Standard Input/Output
        2. Server-Sent Events (SSE)
      2. Development
        1. Testing
        2. Pre-commit Hooks
      3. Documentation
        1. License
          ID: hcctr0h0vs