AgentOps API MCP 服务器

一个允许 LLM 代理通过 AgentOps API 访问轨迹数据的 Model Coordination Protocol (模型协调协议) 服务器。

概述

此 MCP 服务器为代理提供以下功能：

• 列出项目中的最近轨迹
• 获取特定轨迹的详细信息

服务器处理身份验证和与 AgentOps API 的通信，使代理能够轻松访问其轨迹数据。

身份验证流程

该服务器采用安全的两步认证过程：

1. 代理在每次请求中提供其 AgentOps API 密钥
2. 服务器使用此 API 密钥从 AgentOps API 换取 JWT 令牌
3. 服务器使用此 JWT 令牌进行身份验证以访问 AgentOps API
4. 所有响应均以原始形式返回给代理

这确保了 API 密钥在请求之间从未被存储，并且每个请求都通过 JWT 令牌安全地进行身份验证。

可用工具

list_traces

列出代理项目的最近轨迹。

参数：

• AGENTOPS_API_KEY（必需）：代理的 AgentOps API 密钥
• limit（可选）：要返回的最大轨迹数（默认值：5）
• AGENTOPS_API_URL（可选）：非生产环境的自定义 API URL

响应：

• 包含轨迹 ID、跨度数量、开始/结束时间的轨迹列表
• 数据库中总轨迹数
• 按创建时间戳排序（按最近到最早）

trace_detail

获取特定轨迹的详细信息。

参数：

• AGENTOPS_API_KEY（必需）：代理的 AgentOps API 密钥
• trace_id（必需）：要检索其详细信息的轨迹 ID（从 list_traces 响应中的 trace_id 字段获取）
• AGENTOPS_API_URL（可选）：非生产环境的自定义 API URL

响应：

• 轨迹的详细信息
• 与轨迹关联的所有跨度
• 元数据、时间信息等。

使用方法

与 Claude Coder 配合使用（推荐）

此 MCP 服务器设计用于与 Claude Coder 配合使用。按照以下步骤进行配置：

1. 配置 Claude Coder

   在你的 Claude Coder 配置文件中添加以下内容（通常为 ~/.config/claude/config.yml）：

agents:
  - type: mcp_server
    name: AgentOps MCP Server
    config:
      server_url: "http://localhost:8000"

2. 运行服务器

   在终端中运行以下命令以启动 MCP 服务器：

python3 -m mcp_server --host localhost --port 8000

架构

该系统由三个主要组件组成：

• Client：负责与代理交互并接收请求。
• Tools：包含 list_traces 和 trace_detail 等功能模块。
• Server：处理身份验证、通信和请求处理。

未来增强

• 添加更多 AgentOps API 工具（指标、跨度等）
• 支持过滤和搜索轨迹
• 批量操作以提高性能
• 缓存 JWT 令牌以实现短期优化