MCP Server Agentops

🚀 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 令牌進行短時間緩存。