Agentops MCP Server

代理操作API MCP服务器

一种MCP（模型协调协议）服务器，允许LLM代理与AgentOps API交互以访问跟踪数据。

概述

此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（从 trace_id 字段在 list_traces 响应）
• AGENTOPS_API_URL （可选）：用于非生产环境的自定义API URL

答复：

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

用法

与Claude Coder一起使用（推荐）

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

1. 配置Claude编码器

将其添加到您的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 integration for accessing trace data"

替换 /ABSOLUTE/PATH/TO 以及此存储库的实际路径。

1. 与Claude Coder一起使用

   # Run Claude with the AgentOps API MCP server enabled
   claude --mcp agentops-api

   # Or for a single command
   claude --mcp agentops-api "List my recent traces. My API key is xyz123"

1. 在对Claude的提示中，包括您的AgentOps API密钥：

   Can you show me my recent traces? Find my agentops api key in my user .env file. 

独立运行

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

# Using the convenience script
./bin/run-server

# Or using Python directly
uv run -m mcp_server_agentops_api

服务器使用的生产AgentOps API位于 https://api.agentops.ai 默认情况下。代理可以根据每个请求覆盖此URL。

可用工具调用

通过Claude使用MCP服务器时，可以使用以下工具：

# List recent traces
list_traces(AGENTOPS_API_KEY="your-api-key", limit=10)

# Get details for a specific trace
trace_detail(AGENTOPS_API_KEY="your-api-key", trace_id="148dac266d95c9dc0b5616320b8488c9")

# Using a custom API URL (e.g., for local development)
list_traces(AGENTOPS_API_KEY="your-api-key", AGENTOPS_API_URL="http://localhost:8000")

建筑

该代码由三个主要部分组成：

1. 客户(client.py)：处理与AgentOps API的通信，包括身份验证
2. 工具(tools.py)：定义代理可用的工具并处理工具请求
3. 服务器(server.py)：实现代理与之交互的MCP服务器

每个请求都是无状态的，请求之间不存储用户数据，原始API响应直接返回给代理。

码头工人

# Build and run the Docker container
docker build -t mcp-server-agentops-api .
docker run mcp-server-agentops-api

未来的增强功能

• 附加AgentOps API工具（度量、跨度等）
• 支持过滤和搜索痕迹
• 批处理操作以提高性能
• 短期缓存JWT令牌