Opik MCP Server
⚠️ Примечание: поддержка транспорта SSE (Server-Sent Events) в настоящее время экспериментальная и непроверенная. Для производственного использования мы рекомендуем использовать подход прямого выполнения процесса, показанный в примерах интеграции IDE.
🚀 Что такое Opik MCP Server?
Opik MCP Server — это реализация Model Context Protocol с открытым исходным кодом для платформы Opik. Он предоставляет унифицированный интерфейс для взаимодействия с возможностями Opik, поддерживая несколько транспортных механизмов для гибкой интеграции в различные среды.
Вы можете использовать Opik MCP Server для:
Интеграция с IDE:
Простая интеграция с Cursor и другими совместимыми IDE
Предоставьте прямой доступ к возможностям Opik из вашей среды разработки
Унифицированный API-доступ:
Доступ ко всем функциям Opik через стандартизированный протокол
Используйте несколько вариантов транспорта (stdio, SSE) для различных сценариев интеграции
Управление платформой:
Управляйте подсказками, проектами, трассировками и метриками через единый интерфейс
Эффективно организуйте и отслеживайте ваши заявки на получение степени LLM
Related MCP server: dap-mcp
Функции
Управление подсказками : создание, перечисление, обновление и удаление подсказок.
Управление проектами/рабочими пространствами : организация и управление проектами
Трассировки : отслеживание и анализ данных трассировки
Метрики : сбор и запрос данных метрик
Быстрый старт
Установка
Ручная установка
# 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 на ваш фактический ключ API Opik.
Доступные команды
Проект включает 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Предварительные фиксации Хуков
В этом проекте используются хуки pre-commit для обеспечения качества кода:
# Run pre-commit checks manually
make precommitДокументация
Транспорт SSE - Подробности использования транспорта SSE
Справочник API — Полная документация API
Конфигурация — Расширенные параметры конфигурации
Интеграция с IDE — Интеграция с Cursor IDE
Цитата
Если вы используете этот проект в своих исследованиях, пожалуйста, укажите ссылку на него следующим образом:
Comet ML, Inc, Koc, V., & Boiko, Y. (2025). Opik MCP Server. Github. https://doi.org/10.5281/zenodo.15411156Или используйте следующую запись BibTeX:
@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}
}Информацию о цитировании вы также можете найти в файле CITATION.cff в этом репозитории.
Лицензия
Апач 2.0
Available Tools
19 toolscreate-projectCInspect
Create a new project/workspace
Inputs: name (required), description, workspaceName.
create-promptCInspect
Create a new prompt
Inputs: name (required).
create-prompt-versionCInspect
Create a new version of a prompt
Inputs: commit_message (required), name (required), template (required).
delete-projectCInspect
Delete a project
Inputs: projectId (required), workspaceName.
delete-promptCInspect
Delete a prompt
Inputs: promptId (required).
get-metricsCInspect
Get metrics data
Inputs: endDate, metricName, projectId, projectName, +1 more.
get-opik-examplesCInspect
Get examples of how to use Opik Comet's API for specific tasks
Inputs: task (required).
get-opik-helpBInspect
Get contextual help about Opik Comet's capabilities
Inputs: topic (required), subtopic.
get-opik-tracing-infoCInspect
Get information about Opik's tracing capabilities and how to use them
Inputs: topic.
get-project-by-idCInspect
Get a single project by ID
Inputs: projectId (required), workspaceName.
get-prompt-by-idCInspect
Get a single prompt by ID
Inputs: promptId (required).
get-server-infoBInspect
Get information about the Opik server configuration
Inputs: random_string.
get-trace-by-idCInspect
Get a single trace by ID
Inputs: traceId (required), workspaceName.
get-trace-statsCInspect
Get statistics for traces
Inputs: endDate, projectId, projectName, startDate, +1 more.
list-projectsCInspect
Get a list of projects/workspaces
Inputs: page (required), size (required), sortBy, sortOrder, +1 more.
list-promptsCInspect
Get a list of Opik prompts
Inputs: page (required), size (required).
list-tracesCInspect
Get a list of traces
Inputs: page (required), size (required), projectId, projectName, +1 more.
update-projectCInspect
Update a project
Inputs: projectId (required), description, name, workspaceName.
update-promptCInspect
Update a prompt
Inputs: name (required), promptId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Each tool has a clearly distinct purpose targeting specific resources (projects, prompts, traces, metrics, help) and actions (create, get, list, update, delete). There is no overlap or ambiguity between tools, making it easy for an agent to select the right one for any operation.
All tools follow a consistent verb_noun pattern with hyphens (e.g., create-project, get-project-by-id, list-projects). The naming is uniform across all 19 tools, using clear verbs like create, get, list, update, and delete paired with specific nouns.
With 19 tools, the count is slightly high but reasonable for a comprehensive server covering projects, prompts, traces, metrics, and help. It feels well-scoped for the Opik domain, though it borders on being heavy compared to typical 3-15 tool ranges.
The tool set provides complete CRUD/lifecycle coverage for projects and prompts (create, get, list, update, delete), with additional tools for traces, metrics, and help. There are no obvious gaps; agents can perform all core operations without dead ends in this domain.
Maintenance
Related MCP Connectors
A Model Context Protocol server for Wix AI tools
Model Context Protocol server for Studex tools, notifications, and profile integrations
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Related MCP Servers
- FlicenseBqualityDmaintenanceImplements the Model Context Protocol (MCP) to provide AI models with a standardized interface for connecting to external data sources and tools like file systems, databases, or APIs.1153-
- AlicenseNot gradedqualityDmaintenanceAn implementation of the Model Context Protocol (MCP) that enables interaction with debug adapters, allowing language models to control debuggers, set breakpoints, evaluate expressions, and navigate source code during debugging sessions.41AGPL 3.0
- FlicenseNot gradedqualityDmaintenanceA Python-based implementation of the Model Context Protocol that enables communication between a model context management server and client through a request-response architecture.-
- -licenseNot gradedqualityDmaintenanceA standardized foundation for building Model Context Protocol servers that integrate with VS Code, using Python with stdio transport for seamless AI tool integration.-