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 令牌以實現短期優化