STARWARCLOUD STARWAR.AI
返回市场
全球ping-MCP服务器

全球ping-MCP服务器

作者：jsdelivr33 星标更新：2025-11-23
安装使用来源：spider==github.com

项目介绍

Globalping MCP Server

<p align="center"> <img src="https://raw.githubusercontent.com/jsdelivr/globalping-media/refs/heads/master/logo/full_colored_dark.svg" alt="Globalping Logo" width="180"/> </p> <p align="center"> <b>启用AI模型通过自然语言与全球网络测量平台进行交互。为任何LLM提供网络访问。</b> </p> <p align="center"> <a href="https://github.com/modelcontextprotocol/modelcontextprotocol"> <img src="https://img.shields.io/badge/MCP-compatible-brightgreen.svg" alt="MCP 兼容"> </a> </p>

什么是Globalping？

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

什么是Globalping MCP Server？

Globalping MCP Server 实现了Model Context Protocol (MCP)，允许像OpenAI的GPT和Anthropic的Claude这样的AI模型通过自然语言与Globalping的网络测量能力进行交互。

它还支持两种身份验证方法：OAuth和API令牌认证。这两种方法都提供了安全地与我们的API交互的方式，并且与您的账户相关联的速率限制更高。

主要特点

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

安装

远程MCP服务器可用的端点如下：

  • 可流式传输的HTTP传输：https://mcp.globalping.dev/mcp
  • SSE传输：https://mcp.globalping.dev/sse

您可以将我们的Globalping MCP服务器与支持Model Context Protocol的各种AI工具集成。

以下是三种最流行的工具的安装说明：

Claude桌面应用

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

可流式传输的HTTP传输：

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/mcp"
            ]
        }
    }
}

旧版SSE传输：

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/sse"
            ]
        }
    }
}

Anthropic Claude API（通过控制台）

当在Anthropic控制台创建Claude助手时：

  1. 访问console.anthropic.com
  2. 导航到助手部分
  3. 创建一个新的助手或编辑现有的助手
  4. 在工具部分，选择“添加自定义工具”
  5. 输入以下详细信息：
    • 工具名称：Globalping
    • 描述：从世界各地的位置运行网络测试
    • 工具URL：https://mcp.globalping.dev/mcp（可流式传输的HTTP传输）或https://mcp.globalping.dev/sse（SSE传输）

Cursor

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

  1. 打开Cursor设置
  2. 导航到MCP标签页
  3. 点击“+ 添加新的全局MCP服务器”
  4. 这将打开mcp.json配置文件，在其中您需要添加：

可流式传输的HTTP传输：

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/mcp"
            ]
        }
    }
}

旧版SSE传输：

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/sse"
            ]
        }
    }
}
  1. 点击“保存”并重新启动Cursor

身份验证

Globalping MCP服务器支持两种身份验证方法：

  • OAuth身份验证：由服务器自动处理以实现安全访问
  • API令牌身份验证：通过Authorization头手动配置令牌

这两种方法都提供了更高的速率限制和优先访问探测器网络。

使用Globalping API令牌

服务器会自动检测是否在Authorization头中提供了API令牌，并使用它进行身份验证而不是OAuth。

获取您的API令牌

  1. 访问globalping.io
  2. 登录到您的账户
  3. 导航到您的账户设置以生成API令牌

带有身份验证的配置

可流式传输的HTTP传输：

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/mcp",
                "--header",
                "Authorization: Bearer YOUR_GLOBALPING_API_TOKEN"
            ]
        }
    }
}

旧版SSE传输：

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/sse",
                "--header",
                "Authorization: Bearer YOUR_GLOBALPING_API_TOKEN"
            ]
        }
    }
}

连接AI助手

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

  • Claude桌面
  • Anthropic助手
  • Cursor
  • Windsurf
  • 任何MCP协议的自定义实现

请参阅MCP文档以了解如何将客户端连接到此服务器的详细信息。

可用工具

  • ping - 对目标执行ping测试
  • traceroute - 对目标执行traceroute测试
  • dns - 对域名执行DNS查询
  • mtr - 对目标执行MTR（我的traceroute）测试
  • http - 向URL发出HTTP请求
  • locations - 列出所有可用的Globalping探测器位置
  • limits - 显示您当前的Globalping API速率限制
  • getMeasurement - 根据ID检索先前运行的测量结果
  • compareLocations - 如何运行比较测量的指南
  • help - 显示带有可用工具文档的帮助消息

使用示例

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

从欧洲的3个地点ping google.com

从日本运行到github.com的traceroute，并与来自美国的traceroute进行比较

使用Google DNS（8.8.8.8）检查example.com的DNS解析

jsdelivr.com在中国是否可达？同时进行ping和HTTP测试

不同大陆之间cloudflare.com的平均响应时间是多少？

地点指定

地点可以通过“magic”字段指定，该字段支持各种格式：

  • 大洲代码：“EU”，“NA”，“AS”等
  • 国家代码：“US”，“DE”，“JP”等
  • 城市名称：“London”，“Tokyo”，“New York”等
  • 网络名称：“Cloudflare”，“Google”等
  • ASN号码：“AS13335”，“AS15169”等
  • 云提供商区域：“aws-us-east-1”，“gcp-us-central1”等

您还可以使用加号组合这些内容以进行更具体的定位：“London+UK”，“Cloudflare+US”等。

开发

代码库组织成模块：

  • src/index.ts - 主入口点和MCP代理定义
  • src/app.ts - OAuth Web路由
  • src/api - Globalping API客户端
  • src/auth - 身份验证实用程序
  • src/config - 配置和常量
  • src/lib - 工具函数
  • src/mcp - MCP工具处理器
  • src/types - TypeScript类型定义
  • src/ui - HTML模板

添加Globalping凭据

添加Globalping OAuth凭据：

  • npx wrangler secret put GLOBALPING_CLIENT_ID

KV存储

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

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