⚠️ 注意： 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
特徴
プロンプト管理: プロンプトの作成、一覧表示、更新、削除
プロジェクト/ワークスペース管理: プロジェクトの整理と管理
トレース: トレースデータを追跡および分析する
メトリクス: メトリクスデータを収集してクエリする
クイックスタート
インストール
手動インストール
# 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:sseIDE統合
カーソル統合
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-sseSSE トランスポートの詳細については、 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統合- カーソルIDEとの統合
ライセンス
アパッチ 2.0