Globalping

Globalping MCP 服务器

什么是 Globalping？

Globalping是一个免费的公共 API，它提供对全球分布式探测器网络的访问，用于监控、调试和基准测试互联网基础设施。使用 Globalping，您可以从全球数千个地点运行网络测试（ping、traceroute、DNS、MTR、HTTP）。

什么是 Globalping MCP 服务器？

Globalping MCP 服务器实现了模型上下文协议 (MCP) ，允许 OpenAI 的 GPT 和 Anthropic 的 Claude 等 AI 模型通过自然语言与 Globalping 的网络测量功能进行交互。

它还支持 oAuth 身份验证，这提供了一种与我们的 API 交互的安全方式，并受益于与您的帐户相关的更高速率限制。

主要特点

• 🌐全球网络访问：从全球数千个探测器运行测量
• 🤖 AI 友好界面：任何 LLM 都可以轻松解析数据并根据需要运行新的测量
• 📊全面的测量：支持 ping、traceroute、DNS、MTR 和 HTTP 测试
• 🔍智能上下文处理：为 AI 客户端提供详细的参数描述，以便智能地选择测量类型和选项
• 🔄比较分析：允许比较不同目标之间的网络性能
• 🔑 oAuth 支持：使用您自己的 Globalping 帐户来获得更高的速率限制

安装

远程 MCP 服务器可在此端点下使用https://mcp.globalping.dev/sse

您可以将我们的 Globalping MCP 服务器与支持模型上下文协议的各种 AI 工具集成。

以下是 3 种最受欢迎工具的说明：

克劳德桌面应用程序

添加到您的 Claude Desktop 配置文件（位于 Windows 上的%APPDATA%\Claude\config.json或 macOS 上的~/Library/Application Support/Claude/config.json ）：

Anthropic Claude API（通过控制台）

在 Anthropic Console 中创建 Claude 助手时：

1. 前往console.anthropic.com
2. 导航至“助理”部分
3. 创建新助手或编辑现有助手
4. 在“工具”部分中，选择“添加自定义工具”
5. 输入以下详细信息：
   • 工具名称： Globalping
   • 描述： Run network tests from locations worldwide
   • 工具网址： https://mcp.globalping.dev/sse

光标

要将 Globalping MCP 服务器添加到 Cursor：

1. 打开光标设置
2. 导航至 AI 选项卡
3. 向下滚动找到“模型上下文协议”
4. 点击“添加 MCP 服务器”
5. 进入：
   • 名称： Globalping
   • 网址： https://mcp.globalping.dev/sse
   • 勾选“已启用”
6. 点击“保存”

连接人工智能助手

该 MCP 服务器可与任何兼容 MCP 的 AI 助手一起使用，包括：

• 克劳德桌面
• 人类学助理
• 光标
• 风帆冲浪
• MCP 协议的任何自定义实现

有关将客户端连接到此服务器的详细信息，请参阅 MCP 文档。

可用工具

• ping - 对目标执行 ping 测试
• traceroute - 对目标执行 traceroute 测试
• dns执行域名的 DNS 查找
• mtr - 对目标执行 MTR（我的跟踪路由）测试
• http - 对 URL 执行 HTTP 请求
• locations - 列出所有可用的 Globalping 探测位置
• limits - 显示 Globalping API 的当前速率限制
• getMeasurement - 通过 ID 检索先前运行的测量
• compareLocations - 如何运行比较测量的指南
• help - 显示帮助消息以及可用工具的文档

使用示例

一旦通过兼容的 MCP 客户端连接到 AI 模型，您就可以使用自然语言与 Globalping 进行交互：

位置规范

可以使用“magic”字段指定位置，该字段支持多种格式：

• 大陆代码：“EU”、“NA”、“AS”等。
• 国家代码：“US”、“DE”、“JP”等。
• 城市名称：“伦敦”、“东京”、“纽约”等。
• 网络名称：“Cloudflare”、“Google”等。
• ASN 编号：“AS13335”、“AS15169”等。
• 云提供商区域：“aws-us-east-1”、“gcp-us-central1”等。

您还可以将它们与加号组合起来，以实现更具体的定位：“伦敦+英国”、“Cloudflare+美国”等。

发展

代码库分为以下模块：

• src/index.ts - 主入口点和 MCP 代理定义
• src/globalping/types.ts - Globalping API 的 TypeScript 接口
• src/globalping/api.ts - Globalping 的 API 包装函数
• src/globalping/tools.ts - MCP 工具实现
• src/utils.ts - 用于渲染 Web UI 的辅助实用程序

添加 Globalping 凭据

添加 Globalping OAuth 凭证：

• npx wrangler secret put GLOBALPING_CLIENT_ID
• npx wrangler secret put GLOBALPING_CLIENT_SECRET

KV存储

用于OAuthProvider文档https://github.com/cloudflare/workers-oauth-provider

• 创建KV命名空间并复制ID
• 它的绑定必须是OAUTH_KV
• 在wrangler.jsonc文件中配置kv_namespaces