网络监控数据服务

ThousandEyes MCP服务器通过标准化接口将AI助手连接到ThousandEyes平台,使助手能够以自然语言访问和分析网络监控数据。

  • by CiscoDevNet
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 CiscoDevNet/ThousandEyes-MCP-Server-official

使用说明

ThousandEyes MCP服务器

模型上下文协议(MCP)标准化了应用程序如何为大型语言模型(LLM)提供上下文,允许AI助手访问和查询外部数据和工具/API,并将这些查询的结果纳入其响应中。

ThousandEyes MCP服务器允许您将AI助手直接连接到ThousandEyes平台。然后,助手可以使用自然语言通过标准化界面访问和分析ThousandEyes网络监控数据。


先决条件

要使用ThousandEyes MCP服务器,您的组织不得退出ThousandEyes AI功能。此外,您还需要:

  • 这 API Access ThousandEyes用户权限。
  • ThousandEyes API代币。
  • MCP兼容客户端。

有关生成新API令牌的说明,请参阅 用户API令牌.

有关用户权限的详细信息,请参阅 基于角色的访问控制.


用法

ThousandEyes MCP服务器的使用计入您的API费率限制。


连接到MCP服务器

要将ThousandEyes MCP服务器与您的AI助手集成,您需要创建一个MCP客户端,或使用支持MCP的框架,并将其配置为向MCP服务器进行身份验证。

以下部分概述了常见MCP兼容客户端的示例配置。有关更详细的说明,请参阅相关的客户文档。

注: 下面显示的配置是示例。您需要根据自己的需要调整配置。例如,Windows用户将需要更换 command 指定npx位置的行:

"command": "C:\\Progra~1\\nodejs\\npx.cmd"

这 <THOUSANDEYES_API_TOKEN> 变量应替换为您的API令牌。


克劳德桌面

要使用Claude Desktop,请更新中的配置 claude_desktop_config.json 如下图所示。此示例配置使用 npx mcp-remote 命令,它充当本地代理。来自Claude Desktop客户端的请求被拦截,必要的 授权 在将请求转发到ThousandEyes MCP服务器之前注入标头。

此方法对于没有用于添加自定义请求头的本机接口的客户端非常有用。

注: 不支持Claude web界面。

附加先决条件:

  • 你需要安装Node.js。有关说明,请参阅 Node.js文档.

OAuth承载令牌

{
  "mcpServers": {
    "thousandeyes-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://api.thousandeyes.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "<insert your token>"
      }
    }
  }
}

OAuth2动态客户端配置(DCR)

注: 如果使用OAuth2动态客户端配置(DCR)身份验证,则需要浏览器启用访问并与客户端共享令牌。

{
  "mcpServers": {
    "thousandeyes-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://api.thousandeyes.com/mcp",
        "--transport",
        "http-only"
      ]
    }
  }
}

光标IDE

Cursor IDE的MCP客户端允许直接指定自定义HTTP标头 授权 每个请求都会向MCP服务器发送标头。

OAuth承载令牌

{
  "mcpServers": {
    "thousandeyes-mcp-remote": {
      "url": "https://api.thousandeyes.com/mcp",
      "headers": {
        "Authorization": "Bearer <THOUSANDEYES_API_TOKEN>"
      }
    }
  }
}

OAuth2动态客户端配置(DCR)

注: 如果使用OAuth2动态客户端配置(DCR)身份验证,则需要浏览器启用访问并与客户端共享令牌。

{
  "mcpServers": {
    "thousandeyes-mcp-remote": {
      "url": "https://api.thousandeyes.com/mcp"
    }
  }
}

VS代码

VS Code的输入变量允许您在IDE中为用户输入API令牌创建安全提示,而不是将令牌硬编码到配置文件中。

这 ${input:te-key} 然后在运行时用输入的键动态替换变量,防止令牌意外保存到源代码管理中。

附加先决条件:

  • 你需要安装Node.js。有关说明,请参阅 Node.js文档.
  • 副驾驶功能必须在VS代码中启用。

OAuth承载令牌

{
  "inputs": [
    {
      "type": "promptString",
      "id": "te-key",
      "description": "ThousandEyes API Key",
      "password": true
    }
  ],
  "servers": {
    "mcp-thousandeyes": {
      "url": "https://api.thousandeyes.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:te-key}"
      }
    }
  }
}

AWS Kiro

使用以下配置示例作为创建 ~/.kiro/settings/mcp.json 文件。

附加先决条件:

  • 你需要安装Node.js。有关说明,请参阅 Node.js文档.

OAuth承载令牌

{
  "mcpServers": {
    "thousandeyes-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://api.thousandeyes.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "<THOUSANDEYES_API_TOKEN>"
      }
    }
  }
}

OAuth2动态客户端配置(DCR)

注: 如果使用OAuth2动态客户端配置(DCR)身份验证,则需要浏览器启用访问并与客户端共享令牌。

{
  "mcpServers": {
    "thousandeyes-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://api.thousandeyes.com/mcp",
        "--transport",
        "http-only"
      ]
    }
  }
}

MCP服务器功能和示例提示

建议: 使用您启用的工具时要有选择性。同时启用太多工具可能会导致MCP服务器性能下降,包括延迟响应和超时。

核心监控

工具 说明 示例提示
列出测试 查看所有已配置的测试(web应用程序、服务、被监控的网络)。 “我正在运行哪些测试?”/“我正在监视哪些应用程序?”
获取测试详细信息 检索特定测试的详细信息。 “你能给我提供详细信息吗 测试名称 测试?"
列出事件 在一定时间范围内发现网络和应用程序问题。 “我有任何活动吗?”/“今天下午3点有任何活动么?”
获取事件详细信息 深入了解受影响目标、位置和代理的特定事件。 “你能提供活动的详细信息吗 名字 或事件 数字 从名单上?"
列表警报 查看触发或清除的警报。 “我是否有任何活动警报?”/“我是否对以下对象有任何警报 时间?"
获取警报详细信息 获取有关特定警报的全面信息。 “你能给我提供更多细节吗 关键的 警觉的?"
搜索中断 使用各种过滤器查找网络和应用程序中断。 “过去24小时内发生了哪些中断?”/“您能提供更多关于 应用程序/网络 停电?"
即时测试 主动故障排除--按需运行和重新运行测试。 “运行HTTP测试 https://example.org 来自我们的西雅图和旧金山代理商。"

高级分析

工具 说明 示例提示
获取异常 检测测试数据中随时间变化的度量异常。 “你能在过程中发现异常吗 时间段 用于测试 测试名称?"
获取指标 检索自定义仪表板和报告的聚合指标。 “你能检索到 测试名称 从 时间/日期?"

人工智能技能

工具 说明 示例提示
视图解释 解释具体的测试结果和可视化。 “解释网络路径 测试 在 时间/日期."

终点监测

工具 说明 示例提示
列出端点代理和测试 列出带有筛选和测试的端点代理。 “显示我的所有端点代理。”/“我部署了哪些端点代理?”
获取端点代理指标 来自端点代理(网络、web、无线、蜂窝指标)的时间序列数据。 “获取过去一小时的所有Endpoint Agent数据。”/“获取Endpoint Agent的网络性能指标。”

网络路径分析

工具 说明 示例提示
获取路径可视化 查看网络路径和逐跳路由信息。 “我的逐跳网络路径是什么 测试 从 代理 在 时间?"
获取完整路径可视化 所有代理和轮次的全面路径数据。 “网络路径用于什么 测试?“/”网络交换机位于哪些位置?“/”具有mpls跳标签的= 标签?"
获取BGP测试结果 BGP可达性和路由信息。 “BGP测试结果是什么 测试名称 在 时间和日期?"
获取BGP路由详细信息 特定前缀的详细AS路径和路由信息。 “您能提供路线详细信息吗 路线监视器 在 时间和日期?"

账户管理

注: 默认情况下,查询的范围为默认帐户组。要将范围扩展到多个或所有帐户组,您可以在MCP服务器的提示中指定要从哪些帐户组检索数据。

工具 说明 示例提示
获取帐户组 列出可用的帐户组。 “我的默认帐户组是什么?”/“有哪些帐户组 应用 测试在他们?"

故障排除

如果您使用的MCP服务器客户端使用 npx 并遇到 command not found 错误,您可能没有安装Node.js。有关说明,请参阅 Node.js文档.

您可以使用以下命令来验证终端中是否正确安装了Node.js:

# bash% node --version
v22.18.0
# npx --version
10.9.3

来源: ThousandEyes文档 --最后更新于2026年2月 ©2025思科系统股份有限公司及其附属公司。保留所有权利。