sonde (Physikal)

松德

 ](https://www.npmjs.com/package/@sonde/agent) 

AI基础设施代理。 让克劳德看看你的服务器。

Sonde是一个中心辐射系统，允许AI助手从远程基础设施收集诊断数据。集线器服务于Claude（或任何MCP客户端）连接到的MCP端点。轻量级代理在目标机器上运行，通过WebSocket连接出站。集成包直接从集线器连接到企业系统（ServiceNow、Citrix、Proxmox、Splunk等），无需代理。

Claude ──MCP──▸ Hub ──WebSocket──▸ Agent ──probe──▸ Server
                 │
                 ├── SQLite (audit, config, sessions)
                 ├── 8 agent packs (35 probes)
                 ├── 19 integration packs
                 └── Dashboard (React SPA)

快速开始

1.部署Hub

docker run -d --name sonde-hub \
  -p 3000:3000 \
  -e SONDE_SECRET=your-secret-key-min-16-chars \
  -e SONDE_ADMIN_USER=admin \
  -e SONDE_ADMIN_PASSWORD=your-admin-password \
  -v sonde-data:/data \
  ghcr.io/physikal/hub:latest

打开 http://localhost:3000 访问仪表板并完成安装向导。该向导创建一个管理员帐户并生成您的第一个API密钥。

窗户： 下载 .msi 安装程序来自 。它捆绑了Node.js、集线器、仪表板，并作为Windows服务安装。请参阅 Windows部署文档 了解详情。

2.安装代理

从仪表板，转到 管理>报名，生成一个令牌，并在目标计算机上运行显示的命令：

curl -fsSL https://your-hub:3000/install | bash

这将安装Node.js 22和 @sonde/agent，然后打印运行交互式设置的指令。如果您的终端支持它，TUI会自动启动。

或者使用npm手动安装：

npm install -g @sonde/agent
sonde enroll --hub https://your-hub:3000 --token 
sonde start --headless

默认情况下，每个代理都有一个唯一的名称(hostname-)以防止身份冲突。覆盖 --name 如果需要的话。

3.连接克劳德

您需要一个API密钥进行连接。在仪表板中创建一个 管理>API密钥 （管理员）或 我的API密钥 （自助服务，每位用户最多5个）。

克劳德代码：

claude mcp add sonde --transport http https://your-hub:3000/mcp \
  --header "Authorization: Bearer your-api-key"

克劳德桌面版 --添加到配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "sonde": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-hub:3000/mcp",
        "--header",
        "Authorization: Bearer your-api-key"
      ]
    }
  }
}

然后问： *“我的服务器上的磁盘使用情况如何？”*

MCP工具

使用 #tagname 提示中的语法用于按标签过滤（例如。， *“向我展示#prod代理”*).

代理包

8包，35个探头。代理会自动检测已安装的软件并建议相关包。

集成包

直接从集线器连接到企业系统的服务器端包——不需要代理。全部为只读。

在仪表板中配置集成 管理>集成 具有加密凭证存储（AES-256-GCM）。

仪表盘

由中心提供的基于Web的管理UI。特征：

• 舰队 --实时代理状态、标签、批量操作、搜索
• 注册 --使用单行安装命令生成令牌
• API密钥 --具有角色和策略范围的管理员密钥管理
• 我的API密钥 --为会员创建自助密钥（每位用户最多5个）
• 政策 --具有搜索和内联编辑功能的按键访问限制（代理、探测器、客户端）
• 集成 --配置和测试企业系统连接
• 用户和组 --个人用户和Entra安全组授权
• 访问组 --可选范围，将用户限制到特定的代理/集成
• 关键路径 --定义并执行基础设施检查点链
• 趋势 --探测成功/失败趋势、错误模式、人工智能分析
• 审计 --可搜索的哈希链防篡改审计日志
• 试试看 --无需人工智能客户端的交互式探针测试
• 设置 --SSO配置、AI模型设置、MCP提示定制、标签管理

三层RBAC： 成员 （仅MCP）， 管理员 （MCP+仪表板）， 所有者 （管理员+单点登录/设置）。支持本地登录和Entra ID SSO。

安全

跨九层的深度防御：专用无特权用户、无原始shell执行、mTLS、有效载荷签名（RSA-SHA256）、输出清理、代理认证、策略引擎（按密钥代理/探测/客户端限制）、每个边界的Zod模式验证以及防篡改哈希链审计日志记录。

所有探头都是只读的。代理从不监听端口。从任何外部输入到任意shell执行都没有代码路径。请参阅 安全模型 文档。

单体仓库

发展

npm install          # Install all workspace dependencies
npm run build        # Build all packages
npm run test         # Run tests
npm run typecheck    # Type-check
npm run lint         # Lint with Biome

需要Node.js 22+和npm 10+。看 贡献.md 获取完整的开发指南。

文档

完整文档请访问 sondeapp.com.

许可证

Apache 2.0