Agentops MCP Server

🚀 AgentOps API MCP サーバー

このサーバーは、AgentOps API を介して LLM エージェントがトレースデータにアクセスできるようにする Model Coordination Protocol (MCP) サーバーです。このサーバーにより、エージェントはトレースデータを簡単に取得できます。

🚀 クイックスタート

AgentOps API MCP サーバーは、LLM エージェントが AgentOps API を介してトレースデータにアクセスできるようにする MCP サーバーです。エージェントには、プロジェクト内の最近のトレースをリストする機能や、特定のトレースの詳細情報を取得する機能が提供されます。

✨ 主な機能

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

📦 インストール

このセクションでは、原文档にインストール手順が記載されていないため、省略されています。

💻 使用例

基本的な使用法

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

📚 ドキュメント

認証フロー

このサーバーは、安全な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

レスポンス:

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

🔧 技術詳細

このセクションでは、原文档に技術詳細が記載されていないため、省略されています。

📄 ライセンス

このセクションでは、原文档にライセンス情報が記載されていないため、省略されています。