MSPbots Fleet Platform API 的 MCP 服务器——基于 fleetdm 的多租户控制台：主机清单、按需脚本和已保存的 osquery 查询，通过 MCP 暴露给客户端。
它采用与姊妹服务 mspbots-agent-mcp 相同的设计：无状态、不存储凭据、通过 Model Context Protocol（Streamable HTTP/SSE 传输）进行按请求的头认证。
此 MCP 封装的是 MSPbots 内部产品（设备群管理），而非第三方集成。典型用途：
"该租户有哪些主机，哪些处于离线状态？" → mspbotsfleet_list_hosts
"将此笔记本电脑标记为生产环境" → mspbotsfleet_set_host_labels
"这台机器看起来已过期，强制刷新" → mspbotsfleet_refetch_host
"在那台服务器上运行我们的日志收集脚本" → mspbotsfleet_run_script
"现在所有 Windows 主机的磁盘使用情况如何？" → 使用 mspbotsfleet_create_query 创建保存的查询，然后 mspbotsfleet_run_query
"一批新笔记本电脑刚注册，认领我们声明过的那批" → mspbotsfleet_claim_hosts
"我们要停用这台设备，不再将其视为我们的（但保留在 Fleet 中）" → mspbotsfleet_release_host
Related MCP server: OpsLevel MCP
所有工具的凭证均来自请求头（X-MSP-Token / X-MSP-Tenant-Id / X-MSP-Host），
工具参数里不需要传 token。
主机无法通过接口创建：机器装上 fleetd 并注册后自动出现，再按本租户声明过的标识符
（主机名/序列号/UUID）认领归属，见 mspbotsfleet_claim_hosts。
Tool | 功能 | 参数 |
| 列出当前租户的主机（模糊搜索+状态过滤+分页） |
|
| 获取主机详情+手动标签 |
|
| 列出该主机可执行的脚本 |
|
| 全量替换主机的手动标签 |
|
| 请求主机下次签入时刷新属性（异步） |
|
| 从 Fleet 移除主机并清除归属（fleetd 未卸载会再次注册） |
|
| 声明标识符并接管匹配到的无主主机（幂等，可重复调用重试未匹配的） |
|
| 放弃本租户对某主机的归属，不删除主机本身（幂等） |
|
主机列表为全量拉取后在内存过滤/排序/分页，Fleet 侧数据缓存 15 秒，归属信息实时查库不进缓存。
claim_hosts返回{claimed, waiting, rejected}：waiting是已声明但主机还没出现在 Fleet 里，rejected是标识符已被别的租户声明过。
Tool | 功能 | 参数 |
| 列出本租户脚本 |
|
| 获取脚本详情（含正文） |
|
| 新建脚本（文件名须以 |
|
| 替换脚本正文（文件名不可改） |
|
| 删除脚本（对所有主机生效） |
|
| 在主机上执行脚本 |
|
| 查询执行结果（ |
|
create_script/update_script只返回{id, name}，时间戳等其余字段需再查mspbotsfleet_get_script/mspbotsfleet_list_scripts。
Tool | 功能 | 参数 |
| 列出本租户查询 |
|
| 获取查询详情（含 SQL） |
|
| 新建保存查询（仅允许单条 SELECT / WITH…SELECT）。非幂等——重复调用会建出多个查询 |
|
| 更新查询（partial，只传要改的字段） |
|
| 删除查询及其报表数据 |
|
| 对主机实时执行查询并等待结果（≤45s） |
|
SQL 校验规则：只允许单条
SELECT或WITH … SELECT，末尾分号自动去除，正文中出现;直接拒绝。这些校验由后端执行，本服务不重复校验。
docker compose up --build服务器启动在 http://localhost:8080。
uv sync
python -m mspbots_fleet_mcpcurl http://localhost:8080/health
# {"status": "ok"}健康检查端点无需任何凭据。
对 /mcp 的每个请求都必须包含以下 HTTP 头（由 MCP 调用方提供——与 mspbots-agent-mcp / ticketqa-mcp 保持一致）：
Header | 类型 | 是否必填 | 字段描述 | Example |
| string | 必填 | Fleet Platform 已签发的访问凭证 (JWT bearer token)。本服务原样转发为下游请求的 |
|
| string | 必填 | 租户标识。转发给下游 API 时改名为 |
|
| string | 必填 | Fleet API 所在的 host。 |
|
缺少这三个头中的任何一个都会返回 401 Unauthorized。
下游 Fleet API 本身对鉴权失败（缺 token/签名错误/角色不足）统一返回 403， 不是 401——401 只发生在本服务这一层（缺 gateway header）。
Variable | Default | Description |
|
| Listening port |
|
| Listening host |
POST http://localhost:8080/mcp使用以下方式连接 MCP 客户端：
传输：http（Streamable HTTP / SSE）
请求头：X-MSP-Token、X-MSP-Tenant-Id、X-MSP-Host（均必填）
curl -X POST http://localhost:8080/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "X-MSP-Token: <token>" \
-H "X-MSP-Tenant-Id: <tenant-id>" \
-H "X-MSP-Host: https://agent.mspbots.ai" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": { "name": "mspbotsfleet_list_hosts", "arguments": { "status": "online", "per_page": 10 } }
}'⚠️ 本仓库为公开仓库，请勿在任何提交的文件中写入真实的 token / tenant id 等敏感信息， 上面的
<token>/<tenant-id>仅为占位符。
This server cannot be deployed
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Host any HTTP API as a standard MCP server; auto-distribute to 12+ mainstream agent platforms.
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
