CM

comet-ml/opik-mcp

开发工具官方

本页由 AI 翻译,技术细节请以原文为准。 查看原文

225 stars 37 forks 质量 87 趋势 38Apache-2.0

comet-ml/opik-mcp 是从 https://github.com/comet-ml/opik-mcp. 导入的 MCP 服务器候选

概览

comet-ml/opik-mcp 是从 https://github.com/comet-ml/opik-mcp. 导入的 MCP 服务器候选

概述(AI 翻译)

Opik 的官方模型上下文协议(MCP)服务器,Opik 是开源的 LLM 可观测性与评估平台,由 Comet 构建。 插入你的AI主机(Claude Code、Cursor、VS Code Copilot、Codex、opencode或任何软件) MCP客户端)直接进入你的Opik工作区:读取追踪、记录分数并保存 提示版本,全部来自聊天。

为已经运行Opik并想用同一台驱动的LLM工程师设计的 他们用AI助手编程。


快速开始

一个命令可以在你机器的AI客户端中设置Opik,那就是Claude Code。 包含。它找到你的Opik(保存在~/.opik.config,运行中的那个) localhost,或它询问是哪一个),注册MCP服务器,安装Opik技能 pack,并检查连接。在Opik Cloud上,没有API密钥需要处理: 你的客户端在浏览器中登录。需要uv 并且没有Opik SDK:

没有终端,就像编码代理或脚本一样,给客户端命名:

--ai-client 还会使用 codex、cursor、vscode 和 opencode。运行它 它如何使用保存在 ~/.opik.config 中的 Opik,包含 API 密钥,或一个 在localhost上接听,否则停止并请求--deployment。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Opik MCP Server

The official Model Context Protocol (MCP) server for Opik, the open-source LLM observability and evaluation platform, built by Comet. Plug your AI host (Claude Code, Cursor, VS Code Copilot, Codex, opencode, or any MCP client) directly into your Opik workspace: read traces, log scores, and save prompt versions, all from the chat.

Built for LLM engineers who already run Opik and want to drive it from the same AI assistant they code with.

You:    "Which traces in project 'demo' failed today?"
Claude: → list(entity_type="trace", project_name="demo") → "Three traces failed…"

You:    "Score trace 7f2e… 0.9 on helpfulness with reason 'great recovery'."
Claude: → write(score.create) → done

Quick start

One command sets Opik up in the AI clients on your machine, Claude Code included. It finds your Opik (the one saved in ~/.opik.config, one running on localhost, or it asks which), registers the MCP server, installs the Opik skill pack, and checks the connection. On Opik Cloud there is no API key to handle: your client signs in in the browser. It needs uv and no Opik SDK:

uvx opik@latest mcp configure

Without a terminal, as from a coding agent or a script, name the client:

uvx opik@latest mcp configure --ai-client claude-code --skills

--ai-client also takes codex, cursor, vscode and opencode. Run that way it uses the Opik saved in ~/.opik.config, API key included, or one answering on localhost, and otherwise stops and asks for --deployment.

A coding agent asked to “install opik mcp” gets the full steps, including what to ask the user, from uvx opik-mcp@latest --help. They are the same as Install with a coding agent below.

Registering the server by hand, with the client commands under Set it up by hand, skips the check of which Opik you use and the skill pack, so it is for clients the installer doesn’t support.

Your Opik Server Transport Sign-in
Opik Cloud (www.comet.com) the hosted server, run by Comet Streamable HTTP in the browser (OAuth); no API key
Self-hosted Comet, open-source Opik the local server, this package stdio env vars; an API key only where the deployment needs one

Clients load MCP servers when a session starts, so start a new session afterwards.

Setup guide, troubleshooting and FAQ: comet.com/docs/opik/mcp-server.


Opik Cloud: the hosted server

Comet runs the server at https://www.comet.com/opik/api/v1/mcp. Your client connects over HTTP and opens a browser sign-in the first time. There is nothing to install, no API key, and no workspace to set: the server works in the

在 GitHub 查看完整 README

安装

uvx opik-mcp
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "opik-mcp": { "url": "https://www.comet.com/opik/api/v1/mcp" } } }