Opik Mcp サーバー (モデル コンテキスト プロトコル)
Opikのためのモデルコンテキストプロトコル（MCP）実装により、シームレスなIDE統合とプロンプト、プロジェクト、トレース、メトリクスへの統一されたアクセスが可能になります。
概要
Opik-MCPとは？
Opik-MCPは、統合開発環境（IDE）とのシームレスな統合のために設計されたモデルコンテキストプロトコル（MCP）の実装です。プロンプト、プロジェクト、トレース、メトリクスを管理するための統一されたアクセスポイントを提供し、開発者やデータサイエンティストのワークフローを向上させます。このツールは、機械学習プロセスを効率化し、チーム間のコラボレーションを改善したい人に特に役立ちます。
Opik-MCPの特徴
- シームレスなIDE統合：Opik-MCPは、ユーザーが開発環境を簡単に統合できるようにし、機械学習プロジェクトのさまざまな側面を管理しやすくします。
- 統一されたアクセス：ユーザーは、単一のインターフェースからプロンプト、プロジェクト、トレース、メトリクスにアクセスでき、複数のツールを管理する複雑さを軽減します。
- コラボレーションの強化：このプロトコルは、プロジェクト管理のための共有プラットフォームを提供することで、チームメンバー間のコラボレーションを向上させます。
- オープンソース：Opik-MCPは公開リポジトリであり、貢献を受け入れているため、開発者はその機能や特性を強化できます。
Opik-MCPの使い方
- インストール：まず、GitHubからOpik-MCPリポジトリをクローンします。コマンドを使用します：
git clone https://github.com/comet-ml/opik-mcp.git - セットアップ：リポジトリのREADMEファイルに記載されているセットアップ手順に従って、環境を必要に応じて構成します。
- 統合：お好みのIDEにOpik-MCPを統合します。詳細な手順はリポジトリのドキュメントセクションにあります。
- 使用：Opik-MCPの機能を使用して、機械学習プロジェクトを効果的に管理します。統一されたインターフェースを通じてプロンプト、プロジェクト、トレース、メトリクスにアクセスします。
よくある質問
Opik-MCPはどのプログラミング言語をサポートしていますか？
Opik-MCPは言語に依存しないように設計されており、Python、R、Javaなど、機械学習で一般的に使用されるさまざまなプログラミング言語と一緒に使用できます。
Opik-MCPは無料で使用できますか？
はい、Opik-MCPはApache-2.0ライセンスの下でリリースされたオープンソースプロジェクトであり、無料で使用および変更できます。
Opik-MCPにどのように貢献できますか？
リポジトリをフォークし、変更を加え、プルリクエストを送信することで貢献できます。貢献は歓迎されており、問題を報告したり、機能を提案したりすることもできます。
Opik-MCPに関する詳細情報はどこで見つけられますか？
詳細については、公式のOpik-MCPページを訪れるか、GitHubリポジトリにあるドキュメントを確認してください。
詳細
⚠️ Notice: SSE (Server-Sent Events) transport support is currently experimental and untested. For production use, we recommend using the direct process execution approach shown in the IDE integration examples.
🚀 What is Opik MCP Server?
Opik MCP Server is an open-source implementation of the Model Context Protocol for the Opik platform. It provides a unified interface for interacting with Opik's capabilities, supporting multiple transport mechanisms for flexible integration into various environments.
<br>You can use Opik MCP Server for:
-
IDE Integration:
- Seamlessly integrate with Cursor and other compatible IDEs
- Provide direct access to Opik's capabilities from your development environment
-
Unified API Access:
- Access all Opik features through a standardized protocol
- Leverage multiple transport options (stdio, SSE) for different integration scenarios
-
Platform Management:
- Manage prompts, projects, traces, and metrics through a consistent interface
- Organize and monitor your LLM applications efficiently
Features
- Prompts Management: Create, list, update, and delete prompts
- Projects/Workspaces Management: Organize and manage projects
- Traces: Track and analyze trace data
- Metrics: Gather and query metrics data
Quick Start
Installation
Manual Installation
### 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
Configuration
Create a .env file based on the example:
cp .env.example .env
### Edit .env with your specific configuration
Starting the Server
### Start with stdio transport (default)
npm run start:stdio
### Start with SSE transport for network access (experimental)
npm run start:sse
IDE Integration
Cursor Integration
To integrate with Cursor IDE, create a .cursor/mcp.json file in your project directory with the following configuration:
{
"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",
}
}
}
}
Replace /path/to/node with the path to your Node.js executable and /path/to/opik-mcp with the path to your opik-mcp installation. Also replace YOUR_API_KEY with your actual Opik API key.
Available Commands
The project includes a Makefile for common operations:
### 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
Transport Options
Standard Input/Output
Ideal for local integration where the client and server run on the same machine.
make start-stdio
Server-Sent Events (SSE)
Enables remote access and multiple simultaneous clients over HTTP. Note that this transport option is experimental.
make start-sse
For detailed information about the SSE transport, see docs/sse-transport.md.
Development
Testing
### Run all tests
npm test
### Run specific test suite
npm test -- tests/transports/sse-transport.test.ts
Pre-commit Hooks
This project uses pre-commit hooks to ensure code quality:
### Run pre-commit checks manually
make precommit
Documentation
- SSE Transport - Details on using the SSE transport
- API Reference - Complete API documentation
- Configuration - Advanced configuration options
- IDE Integration - Integration with Cursor IDE
Citation
If you use this project in your research, please cite it as follows:
Comet ML, Inc, Koc, V., & Boiko, Y. (2025). Opik MCP Server. Github. https://doi.org/10.5281/zenodo.15411156
Or use the following BibTeX entry:
@software{CometML_Opik_MCP_Server_2025,
author = {{Comet ML, Inc} and Koc, V. and Boiko, Y.},
title = {{Opik MCP Server}},
year = {2025},
publisher = {GitHub},
url = {https://doi.org/10.5281/zenodo.15411156},
doi = {10.5281/zenodo.15411156}
}
You can also find citation information in the CITATION.cff file in this repository.
License
Apache 2.0
サーバー設定
{
"mcpServers": {
"opik-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--comet-ml--opik-mcp--opik-mcp",
"npm run start"
],
"env": {
"OPIK_API_BASE_URL": "opik-api-base-url",
"OPIK_API_KEY": "opik-api-key",
"OPIK_WORKSPACE_NAME": "opik-workspace-name"
}
}
}
}
