Pingo
Pingo - 本地局域网调试 MCP 服务器
一个 MCP 服务器,以清晰的按服务划分职责的架构提供整套本地网络调试工具,便于扩展。
提供的工具
工具 | 说明 |
| 列出本地 IPv4 接口(名称、IP、子网掩码、MAC) |
| Ping 单个 IPv4 地址,报告存活状态/延迟 |
| 扫描 |
| 使用操作系统原生的 traceroute/tracert 探测到主机或 IP 的路由 |
| 将主机名解析为对应的 IPv4/IPv6 地址 |
| 将 IP 反向解析为主机名 |
| 检查单个 TCP 端口是否开放 |
| 通过原始套接字扫描一段 TCP 端口范围(跨度最大 1024 个端口) |
| 读取操作系统 ARP 缓存,获取局域网内的 IP 到 MAC 映射 |
| 通过 |
| 检查 HTTP(S) 端点是否响应,返回状态码与延迟 |
Related MCP server: Network Ops MCP
设计说明
每个关注点对应一个服务(
src/services/*)——每个服务只做一件事,并被注入到 controller 中。因此,添加新的诊断功能(例如 MTU 发现、带宽测试)只需新增一个服务 + 一次registerTool调用,其他均无需改动。无 shell 注入面。 每条操作系统命令都通过
execFile执行(argv 数组方式,绝不使用 shell 字符串),所有输入在到达命令或套接字之前,都会经过严格的白名单验证(src/utils/validators.ts)。默认有界。 端口扫描跨度上限为 1024 个端口,网段扫描上限为
/24,所有操作都有超时——因此,任一看似的输入都不会挂起进程,也不会演变成无限制的网络扫描。DNS 使用 Node 原生的
dns/promises,完全不借助 shell 命令——为这个听起来风险最高的工具减少了一个 exec 入口。
运行
pnpm install
pnpm dev # tsx src/index.ts, hot-reload dev mode
pnpm build && pnpm start # compiled prod run服务器监听于 http://localhost:3000/mcp。
扩展
添加
src/services/YourService.ts,实现一个IYourService接口(仿照现有服务——无构造函数,含有一个或两个职责单一的方法)。将其加入
PingoMcpController.ts中的PingoServices,并在src/index.ts中实例化。在
registerTools()中添加一个server.registerTool(...)代码块。
这就是全部的扩展入口——其他文件无需任何改动。
This server cannot be deployed
Maintenance
Related MCP Connectors
Free, no-API-key network lookups for AI agents — IP geolocation, DNS, WHOIS, HTTP and SSL/TLS certificate checks, and full domain health reports.
13 privacy-first network, auth & web tools for AI agents — no API key, 60 req/min free.
Network, domain and website diagnostics for AI clients via MCP.
Live web checks for AI agents: sitemaps, robots.txt, URL status, broken links, feeds, citations.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform real network diagnostics on the local machine, including ping, traceroute, DNS lookups, TLS checks, and more.MIT
- FlicenseNot gradedqualityDmaintenanceAggregates network operations tools such as retrieving local network configurations and scanning ports, enabling IT professionals to perform these tasks via natural language.-
- AlicenseAqualityCmaintenanceEnables AI agents to check the health of internet infrastructure and specific services, helping diagnose whether issues are local or external.317 npmISC
- AlicenseAqualityDmaintenanceNetwork diagnostics tool for AI agents that provides DNS lookup, IP geolocation, SSL certificate inspection, WHOIS queries, and HTTP latency testing.516 npm1MIT