
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
Model Context Protocol (MCP) 实现,用于Opik,支持无缝IDE集成和统一访问提示词、项目、跟踪和指标。
什么是MCP服务器?
| 属性 | 详情 |
|---|---|
| Docker镜像 | https://hub.docker.com/repository/docker/mcp/opik |
| 作者 | https://github.com/comet-ml |
| 代码仓库 | https://github.com/comet-ml/opik-mcp |
| Dockerfile | https://github.com/comet-ml/opik-mcp/blob/main/Dockerfile |
| Docker镜像构建方 | Docker Inc. |
| Docker Scout健康评分 | !Docker Scout Health Score |
| 验证签名 | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/opik --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
| 许可证 | Apache License 2.0 |
| 服务器提供的工具 | 简短描述 |
|---|---|
add-trace-feedback | 为跟踪添加反馈分数,用于质量评估和监控。 |
create-project | 创建新项目 |
create-prompt | 创建新提示词 |
get-prompt-version | 获取提示词的特定版本 |
get-prompts | 获取提示词列表,支持可选过滤 |
get-trace-by-id | 获取特定跟踪的详细信息,包括输入、输出、元数据和时序信息 |
get-trace-stats | 获取跟踪的聚合统计信息,包括计数、成本、令牌使用量和随时间变化的性能指标 |
get-trace-threads | 获取跟踪线程(对话分组),查看属于同一对话或会话的相关跟踪 |
list-projects | 获取项目列表,支持可选过滤 |
list-traces | 从项目中获取跟踪列表 |
opik-integration-docs | 提供如何将Opik与LLM应用集成的详细文档 |
save-prompt-version | 保存提示词的新版本 |
search-traces | 高级跟踪搜索,支持复杂过滤和查询功能 |
工具:add-trace-feedback
为跟踪添加反馈分数,用于质量评估和监控。
| 参数 | 类型 | 描述 |
|---|---|---|
scores | array | 要添加的反馈分数数组,每个分数应包含名称和0-1之间的值 |
traceId | string | 要添加反馈的跟踪ID |
workspaceName | string 可选 | 要使用的工作区名称,替代默认工作区 |
工具:create-project
创建新项目
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | 项目名称 |
description | string 可选 | 项目描述 |
workspaceName | string 可选 | 要使用的工作区名称,替代默认工作区 |
工具:create-prompt
创建新提示词
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | 提示词名称 |
description | string 可选 | 提示词描述 |
tags | array 可选 | 提示词标签列表 |
工具:get-prompt-version
获取提示词的特定版本
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | 提示词名称 |
commit | string 可选 | 要获取的特定提交/版本 |
工具:get-prompts
获取提示词列表,支持可选过滤
| 参数 | 类型 | 描述 |
|---|---|---|
name | string 可选 | 按提示词名称过滤 |
page | number 可选 | 分页页码 |
size | number 可选 | 每页项目数 |
工具:get-trace-by-id
获取特定跟踪的详细信息,包括输入、输出、元数据和时序信息
| 参数 | 类型 | 描述 |
|---|---|---|
traceId | string | 要获取的跟踪ID(UUID格式,例如:"123e4567-e89b-12d3-a456-426614174000") |
workspaceName | string 可选 | 要使用的工作区名称,替代默认工作区 |
工具:get-trace-stats
获取跟踪的聚合统计信息,包括计数、成本、令牌使用量和随时间变化的性能指标
| 参数 | 类型 | 描述 |
|---|---|---|
endDate | string 可选 | ISO格式结束日期(YYYY-MM-DD)。示例:"2024-01-31" |
projectId | string 可选 | 用于过滤跟踪的项目ID。若未提供,将使用第一个可用项目 |
projectName | string 可选 | 用于过滤跟踪的项目名称(替代projectId) |
startDate | string 可选 | ISO格式开始日期(YYYY-MM-DD)。示例:"2024-01-01" |
workspaceName | string 可选 | 要使用的工作区名称,替代默认工作区 |
工具:get-trace-threads
获取跟踪线程(对话分组),查看属于同一对话或会话的相关跟踪
| 参数 | 类型 | 描述 |
|---|---|---|
page | number 可选 | 分页页码 |
projectId | string 可选 | 用于过滤线程的项目ID |
projectName | string 可选 | 用于过滤线程的项目名称 |
size | number 可选 | 每页线程数 |
threadId | string 可选 | 要获取的特定线程ID(用于获取对话中的所有跟踪) |
workspaceName | string 可选 | 要使用的工作区名称,替代默认工作区 |
工具:list-projects
获取项目列表,支持可选过滤
| 参数 | 类型 | 描述 |
|---|---|---|
page | number 可选 | 分页页码 |
size | number 可选 | 每页项目数 |
workspaceName | string 可选 | 要使用的工作区名称,替代默认工作区 |
工具:list-traces
从项目中获取跟踪列表。用于基本跟踪检索和概览
| 参数 | 类型 | 描述 |
|---|---|---|
page | number 可选 | 分页页码(从1开始) |
projectId | string 可选 | 用于过滤跟踪的项目ID。若未提供,将使用第一个可用项目 |
projectName | string 可选 | 用于过滤跟踪的项目名称(替代projectId)。示例:"My AI Assistant" |
size | number 可选 | 每页跟踪数(1-100,默认10) |
workspaceName | string 可选 | 要使用的工作区名称,替代默认工作区 |
工具:opik-integration-docs
提供如何将Opik与LLM应用集成的详细文档
工具:save-prompt-version
保存提示词的新版本
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | 提示词名称 |
template | string | 提示词版本的模板内容 |
change_description | string 可选 | 此版本的变更描述 |
metadata | object 可选 | 提示词版本的附加元数据 |
type | string 可选 | 模板类型 |
工具:search-traces
高级跟踪搜索,支持复杂过滤和查询功能
| 参数 | 类型 | 描述 |
|---|---|---|
filters | object 可选 | 键值对形式的高级过滤器。示例:{"status": "error"}、{"model": "gpt-4"}、{"duration_ms": {"$gt": 1000}} |
page | number 可选 | 分页页码 |
projectId | string 可选 | 要搜索的项目ID |
projectName | string 可选 | 要搜索的项目名称 |
query | string 可选 | 用于搜索跟踪名称、输入、输出和元数据的文本查询。示例:"error" 或 "user_query:hello" |
size | number 可选 | 每页跟踪数(最大100) |
sortBy | string 可选 | 排序字段。选项:"created_at"、"duration"、"name"、"status" |
sortOrder | string 可选 | 排序顺序:升序或降序 |
workspaceName | string 可选 | 要使用的工作区名称,替代默认工作区 |
json{ "mcpServers": { "opik": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "OPIK_API_BASE_URL", "-e", "OPIK_WORKSPACE_NAME", "-e", "OPIK_API_KEY", "mcp/opik" ], "env": { "OPIK_API_BASE_URL": "https://www.comet.com/opik/api", "OPIK_WORKSPACE_NAME": "default", "OPIK_API_KEY": "your_api_key" } } } }
为什么使用Docker运行MCP服务器更安全?
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务