SpeedOf.Me

SpeedOf.Me MCP 服务

SpeedOf.Me 的官方 MCP 服务，适用于 SpeedOf.Me。可让 AI Agent 运行真实的互联网速度测试并读取结果：下载速度、上传速度、延迟和抖动，数据来自 130 多个全球边缘服务节点。

"How fast is my connection right now?"
→ 187.4 Mbps down / 41.2 Mbps up / 11 ms latency / 1.8 ms jitter (San Jose)

工具

工具	功能
run_speed_test	运行实时速度测试，并返回下载速度、上传速度、延迟和抖动
get_test_history	返回本地历史记录中的过往测试结果

资源	内容
speedofme://history	最近的测试结果（JSON）
speedofme://config	当前配置和状态

快速开始

1. 获取免费的 API 密钥

注册，然后打开 集成并生成密钥。

2. 将服务添加到 MCP 客户端

{
  "mcpServers": {
    "speedofme": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@speedofme/mcp"],
      "env": {
        "SOM_API_SECRET": "SOM_SECRET_xxx"
      }
    }
  }
}

Claude Code，只需一条命令：

claude mcp add speedofme --env SOM_API_SECRET=SOM_SECRET_xxx -- npx -y @speedofme/mcp

VS Code（Copilot）在 .vscode/mcp.json 中使用 servers，而不是 mcpServers；其余配置块完全相同。Cursor、Windsurf、Zed、Cline、Continue、JetBrains 和 Goose 均使用上面的 JSON。特定客户端的配置以及 Agent 框架示例（LangChain、LlamaIndex、AutoGen、CrewAI、Semantic Kernel）请参阅 集成文档。

3. 重启客户端并请求运行速度测试。

工具参考

run_speed_test

参数	类型	默认值	说明
tests	string[]	all	要运行的测试：download、upload、latency
sustainTime	number	6	每个样本持续测试的秒数（1-8）。值越低速度越快，值越高准确度越高
testTimeout	number	300	整次运行的总耗时上限，单位为秒。0 表示禁用，最小值为 30，最大值为 1800

该工具会以格式化文本返回结果。底层结果如下：

{
  "testId": "abc123",
  "download": 150.5,
  "upload": 45.2,
  "latency": 12,
  "jitter": 2.3,
  "testServer": "San Jose",
  "timestamp": "2026-08-18T10:30:00Z"
}

速度单位为 Mbps，延迟和抖动单位为毫秒。

get_test_history

参数	类型	默认值	说明
limit	number	10	结果数量上限
since	string	none	ISO 日期字符串。仅返回此时间之后的结果

历史记录保存在本地 ~/.speedofme/history.json，上限为 1 MB（约 2,600 条结果）。

也可用作 CLI

同一个包也可以独立运行，无需 MCP 客户端：

SOM_API_SECRET=SOM_SECRET_xxx npx -y @speedofme/mcp --progress   # human readable
SOM_API_SECRET=SOM_SECRET_xxx npx -y @speedofme/mcp --json       # for scripts
npx -y @speedofme/mcp history --limit 5                          # past results
npx -y @speedofme/mcp --help

也可以用作 Node SDK：

const { SpeedTest } = require('@speedofme/mcp');

const test = new SpeedTest({ apiSecret: process.env.SOM_API_SECRET });
const result = await test.run();          // { download, upload, latency, jitter, ... }

完整的 CLI 和 SDK 选项请参阅 npm。

测量原理

自 2011 年以来，SpeedOf.Me 一直以相同方式测量我们所称的真实世界速度。测试不会一次性发送固定大小的数据，而是逐步下载更大的样本，从 128 KB 开始，直到某个样本的耗时超过持续时间（默认为 6 秒），然后报告该样本的速率。上传测试以相反方向采用相同方式进行，延迟和抖动则根据 10 次往返样本计算。测试会连接到 130 多个边缘位置中最近的一个，因此 Agent 得出的数值与用户在浏览器中看到的相同。

每次测试的结果也会显示在你的仪表板中，并提供地理位置、设备和平台细分，以及相对于套餐的使用情况。

详细信息：工作原理。

要求

• Node.js 18 或更高版本
• SpeedOf.Me API 账户和密钥（提供免费套餐）

关于此仓库

此仓库是 MCP 服务的所在地，包含文档、注册表条目（server.json）和问题跟踪器。服务本身以 @speedofme/mcp npm 包的形式分发，其源代码未 在此处发布。

发现 Bug 或希望添加工具？请提交问题，或发送邮件至 [email protected]。

链接

• npm 包
• 开始使用
• API 门户
• API 文档
• 状态

许可证

@speedofme/mcp 包是 Speed of Me, LLC 的专有软件。未经授权，禁止复制或 再分发。本仓库中的文档仅供配合 SpeedOf.Me API 使用。