opik-mcp: open-source MCP для платформы Opik с поддержкой нескольких транспортов и интеграцией с IDE 161

Что такое opik-MCP?

opik-mcp — это проект модели MCP с открытым исходным кодом, реализованный для платформы Opik. Он поддерживает несколько механизмов передачи данных, легко интегрируется в IDE и предоставляет унифицированный интерфейс для доступа к функциям Opik, что упрощает управление подсказками, проектами, данными трассировки и метриками, а также помогает эффективно организовывать и отслеживать приложения на основе больших языковых моделей.

Функциональные особенности opik-mcp

• Унифицированный интерфейс: предоставляет стандартизированный API-интерфейс, позволяющий разработчикам напрямую обращаться к функциям Opik из среды разработки.

• Поддержка нескольких механизмов передачи данных: поддерживаются два механизма — стандартный ввод/вывод (stdio) и server-sent events (SSE). Поддержка SSE на данный момент всё ещё находится на экспериментальной стадии, в рабочей среде рекомендуется использовать stdio.

• Интегрированная среда разработки (IDE): возможна бесшовная интеграция в совместимые IDE, такие как Cursor.

• Управление проектами и подсказками:

• Поддерживается создание, вывод списка, обновление и удаление подсказок (prompts).

• Возможность организации и управления проектами и рабочими пространствами.

• Трассировка и анализ:

• Трассировка и анализ данных трассировки (traces) приложения, помогающие разработчикам лучше понимать поведение приложения.

• Сбор и запрос данных о метриках производительности (metrics) для мониторинга производительности приложения.

Установка и использование opik-mcp

Установка:

Требуется Node.js версии v20.11.0 или выше.

Клонируйте репозиторий и установите зависимости:

git clone https://github.com/comet-ml/opik-mcp.git
cd opik-mcp
npm install
npm run build

Настройка:

Создайте файл .env и при необходимости отредактируйте конфигурацию, например, задав базовый URL API и ключ API.

Конфигурацию можно выполнять с помощью параметров командной строки или переменных среды.

Запуск сервера:

Использование передачи данных stdio (по умолчанию):

npm run start:stdio

Использование передачи данных SSE (экспериментальная):

npm run start:sse

Интеграция с IDE

На примере IDE Cursor интеграцию можно выполнить следующими шагами:

Создайте в каталоге проекта файл .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 и /path/to/opik-mcp необходимо заменить на фактические пути к исполняемому файлу Node.js и к месту установки Opik MCP, а YOUR_API_KEY — на ваш ключ API Opik.

Либо можно вручную добавить Opik MCP Server через страницу настроек Cursor.

Сценарии использования opik-mcp

• Интеграция со средой разработки: благодаря интеграции с IDE разработчики могут напрямую использовать функции Opik в процессе разработки.

• Управление приложениями: управление метриками производительности, данными трассировки и подсказками приложений LLM.

• Отладка и оптимизация: анализ телеметрических данных приложения для помощи в отладке и оптимизации.

• Opik MCP Server предоставляет гибкие варианты развёртывания и мощный функционал, являясь мощным инструментом для разработки и управления приложениями LLM.

Домашняя страница проекта: http://www.comet.com/opik/

GitHub: https://github.com/comet-ml/opik-mcp