Agentops MCP Server

🚀 AgentOps API MCP 服务器

AgentOps API MCP 服务器是一个基于 Model Coordination Protocol（模型协调协议）的服务器，它允许 LLM 代理通过 AgentOps API 访问轨迹数据，为代理提供便捷的数据获取途径。

🚀 快速开始

此 MCP 服务器为代理提供了列出项目中最近轨迹以及获取特定轨迹详细信息的功能。服务器会处理身份验证和与 AgentOps API 的通信，让代理能够轻松访问其轨迹数据。

✨ 主要特性

• 安全的身份验证：采用两步认证过程，确保 API 密钥在请求之间不被存储，每个请求都通过 JWT 令牌安全认证。
• 便捷的数据访问：代理可以方便地列出最近轨迹和获取特定轨迹的详细信息。
• 与 Claude Coder 集成：设计用于与 Claude Coder 配合使用，方便配置和使用。

🔧 技术细节

身份验证流程

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

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

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

系统架构

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

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

📦 安装指南

文档未提及安装步骤，暂不提供。

💻 使用示例

与 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

📚 详细文档

可用工具

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

响应：

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

🚀 未来增强

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