🚀 AgentOps API MCP 服务器

AgentOps API MCP 服务器是一个允许 LLM 代理通过 AgentOps API 访问跟踪数据的 Model Coordination Protocol (MCP) 服务器，为代理提供便捷的数据访问途径。

🚀 快速开始

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

✨ 主要特性

• 身份验证安全：采用安全的两步身份验证过程，确保 API 密钥在请求之间不被存储，每个请求都通过 JWT 令牌安全地进行身份验证。
• 功能丰富：提供 list_traces 和 trace_detail 两个工具，满足代理对跟踪数据的基本需求。
• 灵活配置：支持与 Claude Coder 集成，也可作为独立服务器运行，还能在请求时覆盖默认的 API URL。

🔧 技术细节

身份验证流程

该服务器使用安全的两步身份验证过程：

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

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

可用工具

list_traces

列出代理项目的最近跟踪。 参数：

响应：

• 跟踪列表，包括跟踪 ID、跨度数量、开始/结束时间。
• 数据库中总跟踪数。
• 按创建时间戳排序（按最近顺序）。

trace_detail

获取特定跟踪的详细信息。 参数：

响应：

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

💻 使用示例

与 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 令牌进行短时间缓存。