routerbase

Name: routerbase
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords安全01 周前更新

代码仓库

关于 routerbase

routerbase 是提供命令行和 stdio MCP 服务的工具，可查询路由器默认信息、英国 PSTI／欧盟 CRA 密码合规情况及 MAC 地址。它在本地分类 MAC 地址，并将数据查询转发至 ssid.ai。

主要功能

01带制造商来源的路由器默认登录信息
02英国 PSTI 和欧盟 CRA 合规检查
03本地 MAC 地址分类
04按 MAC 地址查询厂商
05提交带来源的更正

适用场景

01查找路由器型号的出厂凭据
02检查是否符合通用密码规则
03识别 MAC 地址的厂商和类型

MCP 相关

向 MCP 客户端提供路由器默认信息、合规检查、MAC 查询和更正提交工具。它将请求转发至托管的 ssid.ai MCP 服务；提交更正需要 API 密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-routerbase": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/routerbase"
      ]
    }
  }
}

启动命令npx -y @reneturcios/routerbase

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/routerbase0.1.0stdio

ocighcr.io/cloudcorprecords/routerbase:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
slug	string	否	用于标识要获取记录的路由器型号 slug。
brand	string	否	路由器品牌名称；未提供 slug 时，与 model 配合使用。
model	string	否	路由器型号名称；未提供 slug 时与品牌一起使用。

详细介绍

routerbase

routerbase 可回答三类有关家用路由器的问题：某款型号的出厂登录默认信息（网关、登录主机、用户名／密码、凭据类型、重置步骤，以及记录中引用的制造商来源）；某款型号是否符合英国 PSTI 和欧盟 CRA 关于禁止通用默认密码的规定；以及 MAC 地址对应的网络硬件制造商。一款二进制文件同时提供命令行界面和 stdio MCP 服务。

数据存储在托管服务中。routerbase 是一个本地 stdio 服务，会将每次调用转发为 JSON-RPC tools/call 请求，发送到 ssid.ai MCP 端点 https://ssid.ai/mcp/http；这种通信格式是根据该服务的公开说明整理出的文档化重构。设置 SSID_API_BASE（主机或完整的端点 URL）即可将请求发送到其他位置。

读取工具无需密钥且免费。设置 SSID_API_KEY 可提高速率限制；如果存在该密钥，请求会将其作为 Bearer token 发送。 submit_correction 则不同：上游将这个写入工具限制在 Pro 套餐中，因此若未设置 SSID_API_KEY，routerbase 会拒绝请求并说明原因，不会发送任何内容——如果未提交更正，绝不会报告已提交。

对于 lookup_mac，地址分类确实是在本地完成的：地址会经过解析和规范化（接受冒号、连字符、点分隔和纯十六进制格式），根据首个八位组的组播位和本地管理位来区分组播、随机化和通用地址，无法解析的地址则视为无效。只有供应商／OUI 部分来自上游调用；无效地址绝不会发送到上游。

安装

npx @reneturcios/routerbase lookup_mac 00:1A:2B:3C:4D:5E

也可以运行容器镜像：

docker run -i ghcr.io/cloudcorprecords/routerbase

容器默认启动 MCP 服务（见下文）。传入 CLI 参数即可将其用作 CLI。

CLI

routerbase get_router_defaults --slug <slug>
routerbase get_router_defaults --brand <brand> --model <model>
routerbase check_router_compliance --slug <slug>
routerbase lookup_mac 00:1A:2B:3C:4D:5E
routerbase submit_correction --slug <slug> --field gateway_ip \
  --proposed-value 192.168.0.1 --source-url https://example.com/manual

routerbase --version

成功的命令会以 JSON 格式打印结果。退出代码：成功时为 0，调用失败（包括上游错误或更正密钥限制）时为 1，用法错误时为 2。 get_router_defaults 需要 --slug，或同时提供 --brand 和 --model；参数不足会如实报错，不会猜测。

MCP 服务

一个二进制文件支持两种用途。mcp 子命令会启动 stdio MCP 服务：

npx -y @reneturcios/routerbase mcp

MCP 客户端配置：

{
  "mcpServers": {
    "routerbase": {
      "command": "npx",
      "args": ["-y", "@reneturcios/routerbase", "mcp"],
      "env": {
        "SSID_API_KEY": "your key, optional for read tools"
      }
    }
  }
}

工具

工具	输入	返回内容
`get_router_defaults`	`slug`，或 `brand` + `model`	该型号由制造商来源佐证的出厂登录记录。
`check_router_compliance`	`slug`（必填）	该型号对英国 PSTI／欧盟 CRA 通用默认密码规则的符合情况。
`lookup_mac`	`mac`（必填）	本地分类（通用／随机化／组播／无效）、规范化后的地址和 OUI，以及上游供应商数据。
`submit_correction`	`slug`、`field`、`proposedValue`、`sourceUrl`（均必填）	将附有来源的更正排入队列，以供验证。需要 `SSID_API_KEY`（Pro 套餐）。

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx