Opik Mcp Сервер (модель Протокол Контекста)
Реализация Протокола Контекста Модели (MCP) для Opik, обеспечивающая бесшовную интеграцию с IDE и единый доступ к подсказкам, проектам, трассам и метрикам.
Обзор
Что такое Opik-MCP?
Opik-MCP — это реализация Протокола Модельного Контекста (MCP), разработанная для бесшовной интеграции с Интегрированными Средами Разработки (IDE). Он предоставляет единый точку доступа для управления подсказками, проектами, трассировками и метриками, улучшая рабочий процесс для разработчиков и специалистов по данным. Этот инструмент особенно полезен для тех, кто хочет оптимизировать свои процессы машинного обучения и улучшить сотрудничество между командами.
Особенности Opik-MCP
- Бесшовная интеграция с IDE: Opik-MCP позволяет пользователям без усилий интегрировать свою среду разработки, упрощая управление различными аспектами проектов машинного обучения.
- Единый доступ: Пользователи могут получать доступ к подсказкам, проектам, трассировкам и метрикам из одного интерфейса, уменьшая сложность управления несколькими инструментами.
- Улучшенное сотрудничество: Протокол способствует лучшему сотрудничеству между членами команды, предоставляя общую платформу для управления проектами.
- Открытый исходный код: Будучи публичным репозиторием, Opik-MCP открыт для вкладов, позволяя разработчикам улучшать его функции и возможности.
Как использовать Opik-MCP
- Установка: Начните с клонирования репозитория Opik-MCP с GitHub. Используйте команду:
git clone https://github.com/comet-ml/opik-mcp.git - Настройка: Следуйте инструкциям по настройке, предоставленным в файле README репозитория, чтобы настроить окружение в соответствии с вашими потребностями.
- Интеграция: Интегрируйте Opik-MCP с вашей предпочтительной IDE. Подробные инструкции можно найти в разделе документации репозитория.
- Использование: Начните использовать функции 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"
}
}
}
}
