MCP Server Agentops

🚀 AgentOps API MCP サーバー

AgentOps API を通じてLLMエージェントがトレースデータにアクセスできるようにする、Model Coordination Protocol (MCP) サーバーです。このサーバーは、エージェントがAgentOps APIからトレースデータを簡単に取得できるように、認証と通信を処理します。

🚀 クイックスタート

このMCPサーバーを使用することで、エージェントはAgentOps APIからトレースデータを取得できます。以下のセクションでは、サーバーの機能、認証フロー、利用可能なツール、使用方法について説明します。

✨ 主な機能

このMCPサーバーは、エージェントに以下の機能を提供します。

• AgentOpsプロジェクト内の最近のトレースを一覧表示する
• 特定のトレースの詳細情報を取得する

🔧 認証フロー

このサーバーは、安全な2段階認証プロセスを使用します。

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（list_traces レスポンスの trace_id フィールドから取得）
• AGENTOPS_API_URL（オプション）：非本番環境用のカスタムAPI URL

レスポンス：

• トレースの詳細情報
• トレースに関連付けられたすべてのスパン
• メタデータ、時間情報など

💻 使用例

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トークンの短期キャッシュを実装する