Control D MCP

一个本地 Model Context Protocol 服务器，用于通过对话安全地管理 Control D。

它可以检查配置文件和端点，诊断最近被阻止的 DNS 查询，临时暂停配置文件，创建阻止/绕过/重定向规则，以及删除规则。每次实时策略更改都需要 confirm: true，并且之后会进行回读检查。

设置

需要 Node.js 20 或更高版本，以及一个专用的 Control D 写入令牌。尽可能在 Control D 中将令牌限制为受信任的源 IP。

npm install
npm run test

将令牌放在 ~/.config/controld-mcp.env 中（切勿放在此仓库中），并将文件模式设置为 0600：

CONTROL_D_API_TOKEN=your-dedicated-write-token

示例 Codex 配置：

[mcp_servers.controld]
command = "/absolute/path/to/node"
args = ["/absolute/path/to/controld-mcp/dist/index.js"]

添加服务器后重启 MCP 主机。 MCP 进程可以在没有令牌的情况下启动，但在令牌存在并重启主机之前，其工具将返回设置错误。

Related MCP server: technitium-mcp-secure

典型流程

1. “显示我的 Control D 配置文件。”

2. “我刚刚尝试了 example.com。过去五分钟内阻止了什么？”

3. 查看查询时间戳以及触发每个阻止的规则/过滤器。

4. “为 cdn.example.net 在 Global 上创建一个 30 分钟的临时绕过。”

5. 助手会显示确切提议的变更，并在调用确认的写入工具之前请求批准。

对于路由：先列出代理位置，然后将精确域名规则或命名服务重定向到精确的位置 ID。像 YouTube 这样的服务可能涉及许多变化的域名，因此 set_service_policy 通常比手动维护其主机名更安全。

安全设计

• 没有通用的 HTTP/API 直通工具。

• API 和分析主机仅限于 Control D。

• 令牌在运行时加载，从不返回或记录。

• 活动日志请求限制为 200 行，并且从不缓存。

• 写入需要精确的配置文件解析和 confirm: true。

• 优先使用精确域名而不是通配符。在解除任何阻止之前检查结果。

API 稳定性

Control D 警告其 API 未版本化。活动日志和若干管理操作使用当前的第一方仪表板契约，因为它们并非全部出现在公共 API 参考中。请参阅 docs/api-contracts.md。

致谢

端点行为已与 Control D 官方仪表板和社区 Control D Manager Home Assistant 集成 进行了交叉检查。本项目是一个独立的实现。

许可证

MIT