Opik Mcp 服务器（模型上下文协议）
Opik的模型上下文协议（MCP）实现，旨在实现无缝的IDE集成和对提示、项目、跟踪和指标的统一访问。
概览
什么是 Opik-MCP？
Opik-MCP 是一种模型上下文协议（MCP）实现，旨在与集成开发环境（IDE）无缝集成。它提供了一个统一的访问点，用于管理提示、项目、跟踪和指标，从而增强开发人员和数据科学家的工作流程。这个工具特别适合那些希望简化机器学习流程并改善团队协作的人。
Opik-MCP 的特点
- 无缝 IDE 集成：Opik-MCP 允许用户轻松集成他们的开发环境，使管理机器学习项目的各个方面变得更加简单。
- 统一访问：用户可以通过单一界面访问提示、项目、跟踪和指标，减少管理多个工具的复杂性。
- 增强协作：该协议通过提供一个共享的平台来促进团队成员之间的更好协作。
- 开源：作为一个公共存储库，Opik-MCP 欢迎贡献，允许开发人员增强其功能和特性。
如何使用 Opik-MCP
- 安装：首先从 GitHub 克隆 Opik-MCP 存储库。使用以下命令：
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
Server配置
{
"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"
}
}
}
}
