AgentOps API MCP 服务器

一个允许 LLM 代理通过 AgentOps API 访问跟踪数据的 Model Coordination Protocol (MCP) 服务器。

概述

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

• 列出其 AgentOps 项目中的最近跟踪
• 获取特定跟踪的详细信息

该服务器处理身份验证和与 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-cli/config.yaml）：

   mcp_servers:
     - name: agentops-api
       path: /ABSOLUTE/PATH/TO/mcp/agentops-api/bin/run-server
       description: "AgentOps API 集成以访问跟踪数据"
   

   将 /ABSOLUTE/PATH/TO 替换为实际路径到此存储库。

2. 与 Claude Coder 一起使用

   # 启动 Claude 并启用 AgentOps API MCP 服务器
   claude --mcp agentops-api
   
   # 或用于单个命令
   claude --mcp agentops-api "列出我的最近跟踪。请在我的用户 .env 文件中找到我的代理 API 密钥。"
   

3. 在您对 Claude 的提示中包含您的 AgentOps API 密钥：

   您能显示我最近的跟踪吗？请在我的用户 .env 文件中找到我的代理 API 密钥。
   

作为独立服务器运行

如果您需要直接运行服务器：

# 使用方便脚本
./bin/run-server

# 或者直接使用 Python
uv run -m mcp_server_agentops_api

该服务器默认使用生产 AgentOps API https://api.agentops.ai。代理可以在每次请求时覆盖此 URL。

可用工具调用

当通过 Claude 使用 MCP 服务器时，它可以使用的工具有：

# 列出最近跟踪
list_traces(AGENTOPS_API_KEY="your-api-key", limit=10)

# 获取特定跟踪的详细信息
trace_detail(AGENTOPS_API_KEY="your-api-key", trace_id="148dac266d95c9dc0b5616320b8488c9")

# 使用自定义 API URL（例如用于本地开发）
list_traces(AGENTOPS_API_KEY="your-api-key", AGENTOPS_API_URL="http://localhost:8080")

未来改进

• 添加对 AgentOps API 的其他工具支持（指标、跨度等）
• 支持过滤和搜索跟踪
• 批处理操作以提高性能
• 对 JWT 令牌进行短时间缓存