适合谁
- 已在使用 Opik 的 LLM 工程师
- 希望在编码环境中直接管理 LLM 可观测性的开发者
- 需要与 Opik 平台深度集成的工作流
O
67FMRS · C
Opik MCP Server 是 Opik 的官方 MCP 服务器，专为 LLM 可观测性和评估设计，提供丰富的工具集和良好的客户端支持。功能全面，但部分高级功能受限，且安全配置需谨慎。
Opik MCP Server 是 Opik 的官方 Model Context Protocol (MCP) 服务器，由 Comet 构建，用于连接 AI 宿主（如 Claude Code、Cursor、VS Code Copilot）与 Opik 工作区。通过会话界面，你可以读取追踪记录、记录评分、保存提示词版本，并向 Opik 内置 AI 助手 Ollie 提问，实现端到端的 LLM 可观测性与评估工作流。该服务器提供读取、列出、写入、查询、schema 检查和实验运行等工具，支持本地和云端 Opik 部署。
工具能力
read
按 ID、名称或 opik:// URI 读取 Opik 实体（如项目、追踪、跨度、测试套件、实验、提示词）。
list
列出 Opik 实体集合，支持名称过滤和分页。
ask_ollie
通过 Opik 内置 AI 助手 Ollie 进行调查和综合分析，可回答复杂问题并执行写操作。
write
通用写入操作，用于记录追踪/跨度、评分、评论、保存提示词、管理测试套件和实验。
schema
查询写入操作的数据结构、必需字段和示例，帮助构建有效请求。
run_experiment
通过 Ollie 端到端运行评估实验，并将结果写回 Opik。
安装接入
- 安装 uv（
curl -LsSf https://astral.sh/uv/install.sh | sh） - 从你的 Opik 工作区获取
OPIK_API_KEY，并可选设置OPIK_WORKSPACE（默认为default） - 在 MCP 客户端配置中按相应格式添加服务器，使用
uvx opik-mcp命令，并设置环境变量 - 重启客户端，验证连接后即可使用
claude_desktop_config.json
{
"mcpServers": {
"opik-mcp": {
"type": "stdio",
"command": "uvx",
"args": ["opik-mcp"],
"env": {
"OPIK_API_KEY": "<your-key>",
"OPIK_WORKSPACE": "<your-workspace>"
}
}
}
}
选型与风险
不适合谁
- 未使用 Opik 的用户
- 对 LLM 可观测性不感兴趣的用户
- 需要离线或非云功能的用户（ask_ollie 和 run_experiment 仅限 Comet 云）
所需权限
- 读取 Opik 项目、追踪、跨度、测试套件、实验和提示词
- 写入追踪、跨度、评分、评论、提示词版本和实验
- 访问 Opik API 密钥（必需）
风险与副作用
- 需要 API 密钥，可能涉及安全风险
- ask_ollie 和 run_experiment 仅限 Comet 云，自托管环境不可用
- Cursor 强制 60 秒工具调用超时，长时间操作可能失败
- 默认 YOLO 模式自动批准 Ollie 的写入，可能产生意外修改
常见排障
- 如果 `ask_ollie` 报错缺少 API 密钥，请检查环境变量是否在 MCP 客户端配置的 env 块中
- 如果 `ask_ollie` 长时间未响应，可能是 Ollie 冷启动，重试即可
- 自托管环境不支持 ask_ollie 或 run_experiment，请使用 read/list/write
- Cursor 超时可尝试缩短查询或改用 Claude Code
使用场景
快速查询项目、追踪和跨度详情
为追踪或跨度添加评分和评论，用于评估
保存和版本化提示词
通过 Ollie 分析实验回归原因
运行评估实验并查看结果
支持客户端
Claude Code完整支持
Cursor部分支持
VS Code Copilot完整支持
MCP Inspector部分支持