AgentOps API MCP Server
2025.04.12
0
PythonAPI集成跟踪数据管理开发效率
AgentOps API MCP Server 是一个基于模型协调协议（MCP）的服务，旨在为LLM代理提供与AgentOps API交互的能力，以便访问跟踪数据。该服务器简化了代理与AgentOps API的通信过程，提供了安全的认证流程和便捷的数据访问工具。
View on GitHub
Overview
基本能力
产品定位
AgentOps API MCP Server 是一个中间件服务，专门为LLM代理设计，用于简化与AgentOps API的交互，提供跟踪数据的访问和管理功能。
核心功能
- 安全认证流程：采用两步认证机制，确保API密钥的安全性和请求的合法性。
- 跟踪数据访问：提供工具列表和详细跟踪信息查询功能。
- 无状态设计：每个请求都是独立的，不存储用户数据，确保数据隐私和安全。
适用场景
- LLM代理需要访问和管理AgentOps项目中的跟踪数据。
- 开发者在开发或测试环境中需要模拟或查询跟踪数据。
工具列表
list_traces：列出代理项目中的最近跟踪记录。- 参数：
AGENTOPS_API_KEY（必需）、limit（可选）、AGENTOPS_API_URL（可选）。 - 响应：跟踪ID、跨度数量、开始/结束时间等。
trace_detail：获取特定跟踪的详细信息。- 参数：
AGENTOPS_API_KEY（必需）、trace_id（必需）、AGENTOPS_API_URL（可选）。 - 响应：跟踪的详细信息、相关跨度、元数据等。
常见问题解答
- 如何设置Claude Coder？：在配置文件中添加MCP服务器路径和描述。
- 如何运行独立服务器？：使用提供的脚本或直接通过Python运行。
- 如何自定义API URL？：在工具调用时提供
AGENTOPS_API_URL参数。
使用教程
使用依赖
- 确保已安装Python和Docker（如需容器化运行）。
安装教程
- 配置Claude Coder
```yaml
mcp_servers:
- name: agentops-api path: /ABSOLUTE/PATH/TO/mcp/agentops-api/bin/run-server description: "AgentOps API integration for accessing trace data" ```
- 运行Claude Coder
bash claude --mcp agentops-api - 独立运行
bash ./bin/run-serverbash uvicorn run -m mcp_server_agentops_api
调试方式
- 列出跟踪
bash list_traces(AGENTOPS_API_KEY="your-api-key", limit=10) - 获取跟踪详情
bash trace_detail(AGENTOPS_API_KEY="your-api-key", trace_id="148dac266d95c9dc0b5616320b8488c9") - 自定义API URL
bash list_traces(AGENTOPS_API_KEY="your-api-key", AGENTOPS_API_URL="http://localhost:8000")