Globalping MCP Server

全局MCP服务器

Enable AI models to interact with a global network measurement platform through natural language. Give network access to any LLM.

什么是全球化？

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

什么是Globalping MCP服务器？

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

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

主要特点

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

安装

远程MCP服务器在以下端点下可用：

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

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

以下是三大最受欢迎工具的说明：

Gemini CLI

要将Globalping MCP服务器添加到Gemini CLI中，请执行以下操作：

1. 确保你有 Gemini CLI 安装。
2. 运行以下命令：

gemini extensions install https://github.com/jsdelivr/globalping-mcp-server

这将自动配置启用OAuth身份验证的服务器。首次使用该扩展时，系统将提示您登录。

注： 如果您更喜欢使用Globalping API令牌（用于更高的速率限制或自动化），则可以手动添加带有授权标头的服务器，而不是使用扩展安装程序：

gemini mcp add globalping https://mcp.globalping.dev/mcp --header "Authorization: Bearer YOUR_TOKEN"

Claude桌面应用程序

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

\[！注意\] Claude Desktop本机仅支持本地MCP服务器的stdio传输。 对于远程MCP服务器，请使用 mcp-remote 桥。

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

API（通过控制台）

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

1. 首选 console.anthropic.com
2. 导航到“助理”部分
3. 创建新助手或编辑现有助手
4. 在“工具”部分，选择“添加自定义工具”
5. 输入以下详细信息：

- 工具名称： Globalping - 说明： Run network tests from locations worldwide - 工具URL: https://mcp.globalping.dev/mcp （流式HTTP传输）或 https://mcp.globalping.dev/sse （SSE运输）

光标

要将Globalping MCP服务器添加到游标，请执行以下操作：

1. 打开光标设置
2. 导航到“工具和MCP”选项卡
3. 点击“+新建MCP服务器”
4. 这将打开 mcp.json config文件，您需要在其中添加：

可流式HTTP传输：

{
    "mcpServers": {
        "globalping": {
            "url": "https://mcp.globalping.dev/mcp"
        }
    }
}

传统SSE运输：

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

1. 保存并重新启动游标

认证

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

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

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

使用Globalping API令牌

当授权头中提供API令牌时，服务器会自动检测，并将其用于身份验证而不是OAuth。

获取您的API代币

1. 访问 dash.globalping.io
2. 登录您的帐户
3. 导航到令牌以生成新的API令牌

带身份验证的配置

可流式HTTP传输：

{
    "mcpServers": {
        "globalping": {
            "url": "https://mcp.globalping.dev/mcp",
            "headers": {
                "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助手一起使用，包括：

• 克劳德桌面版
• 人类学助理
• 光标
• 帆板运动
• MCP协议的任何自定义实现

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

可用工具

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

使用示例

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

Ping google.com from 3 locations in Europe

Run a traceroute to github.com from Japan and compare with traceroute from the US

Check the DNS resolution of example.com using Google DNS (8.8.8.8)

Is jsdelivr.com reachable from China? Test with both ping and HTTP

What's the average response time for cloudflare.com across different continents?

位置规范

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

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

您还可以将这些与加号结合，以获得更具体的目标：“伦敦+英国”、“Cloudflare+美国”等。

发展

代码库被组织成模块：

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

添加全局设置凭据

添加全局OAuth凭据：

• npx wrangler secret put GLOBALPING_CLIENT_ID

KV储存

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

• 创建KV命名空间并复制ID
• 它必须具有约束力 OAUTH_KV
• 配置 kv_namespaces 在 wrangler.jsonc 文件