返回 MCP 目录
public公开dns本地运行

agentops-mcp

AgentOps MCP服务器提供AI代理运行的可观测性和追踪数据,用于调试和分析代理的成功与失败情况。

article

README

🚀 AgentOps MCP Server

AgentOps MCP服务器可提供可观测性和跟踪数据,用于调试复杂的AI智能体运行情况。这为了解AI智能体的成功或失败之处提供了关键的上下文信息。

🚀 快速开始

MCP客户端配置

将以下内容添加到您的MCP配置文件中:

{
    "mcpServers": {
        "agentops-mcp": {
            "command": "npx",
            "args": ["agentops-mcp"],
            "env": {
              "AGENTOPS_API_KEY": ""
            }
        }
    }
}

📦 安装指南

通过Cursor深度链接安装

安装MCP服务器

通过Smithery安装

要通过 Smithery 为Claude桌面版自动安装agentops-mcp,请执行以下命令:

npx -y @smithery/cli install @AgentOps-AI/agentops-mcp --client claude

本地开发

要在本地构建MCP服务器,请执行以下步骤:

# 克隆并设置
git clone https://github.com/AgentOps-AI/agentops-mcp.git
cd mcp
npm install

# 构建项目
npm run build

# 运行服务器
npm pack

💻 使用示例

基础用法

{
    "mcpServers": {
        "agentops-mcp": {
            "command": "npx",
            "args": ["agentops-mcp"],
            "env": {
              "AGENTOPS_API_KEY": ""
            }
        }
    }
}

高级用法

# 通过Smithery为Claude桌面版自动安装
npx -y @smithery/cli install @AgentOps-AI/agentops-mcp --client claude

📚 详细文档

可用工具

auth

使用AgentOps项目API密钥进行授权并返回JWT令牌。 参数:

  • api_key(字符串):您的AgentOps项目API密钥

get_trace

按ID检索跟踪信息。 参数:

  • trace_id(字符串):要检索的跟踪ID

get_span

按ID获取跨度信息。 参数:

  • span_id(字符串):要检索的跨度ID

get_complete_trace

获取包括所有跨度及其指标的综合跟踪信息。 参数:

  • trace_id(字符串):跟踪ID

要求

  • Node.js >= 18.0.0
  • AgentOps API密钥(作为参数传递给工具)
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端