de en es ja ko ru zh

mspbots-fleet-mcp

Name: mspbots-fleet-mcp
Author: MSPbotsAIFramework

Official

by MSPbotsAIFramework

Overview Schema Source Related Servers Discussions Admin

Python

Remote

mspbots-fleet-mcp

MCP-Server für die MSPbots Fleet Platform API – eine Multi-Tenant-Konsole über fleetdm: Host-Inventar, On-Demand-Skripte und gespeicherte osquery-Abfragen, bereitgestellt für MCP-Clients.

Er folgt demselben Design wie der Schwesterdienst mspbots-agent-mcp: zustandslos, keine gespeicherten Anmeldedaten, Header-Authentifizierung pro Anfrage über das Model Context Protocol (Streamable HTTP/SSE-Transport).

Wann Sie dies verwenden würden

Dieses MCP kapselt ein internes MSPbots-Produkt (Geräte-Fleet-Verwaltung), keine Drittanbieter-Integration. Typische Verwendungen:

„Welche Hosts hat dieser Mandant, und welche sind offline?" → mspbotsfleet_list_hosts
„Dieses Laptop als Production markieren" → mspbotsfleet_set_host_labels
„Diese Maschine sieht veraltet aus, Aktualisierung erzwingen" → mspbotsfleet_refetch_host
„Unser Log-Erfassungsskript auf diesem Server ausführen" → mspbotsfleet_run_script
„Wie hoch ist die Speichernutzung auf allen Windows-Hosts gerade?" → eine gespeicherte Abfrage mit mspbotsfleet_create_query erstellen, dann mspbotsfleet_run_query
„Eine Charge neuer Laptops wurde gerade registriert, die von uns deklarierten übernehmen" → mspbotsfleet_claim_hosts
„Wir nehmen dieses Gerät außer Betrieb, beenden Sie die Verfolgung als unseres (aber lassen Sie es in Fleet)" → mspbotsfleet_release_host

Related MCP server: OpsLevel MCP

Tools

Die Anmeldedaten für alle Tools stammen aus den Request-Headern (X-MSP-Token / X-MSP-Tenant-Id / X-MSP-Host), es müssen keine Token in den Tool-Parametern übergeben werden.

Hosts

Hosts können nicht über die API erstellt werden: Maschinen erscheinen automatisch, nachdem sie fleetd installiert und registriert haben, und werden dann anhand der vom Mandanten deklarierten Kennungen (Hostname/Seriennummer/UUID) übernommen, siehe mspbotsfleet_claim_hosts.

Tool	Funktion	Parameter
`mspbotsfleet_list_hosts`	Listet die Hosts des aktuellen Mandanten auf (Fuzzy-Suche+Statusfilter+Seitennummer)	`search`, `status`(`online`/`offline`/`new`/`missing`), `page`(Standard 0), `per_page`(Standard 25, max. 200)
`mspbotsfleet_get_host`	Ruft Host-Details+manuelle Labels ab	`host_id`(erforderlich)
`mspbotsfleet_list_host_scripts`	Listet die auf diesem Host ausführbaren Skripte auf	`host_id`(erforderlich)
`mspbotsfleet_set_host_labels`	Ersetzt die manuellen Labels des Hosts vollständig	`host_id`(erforderlich), `labels`(erforderlich, vollständige Ersetzung)
`mspbotsfleet_refetch_host`	Fordert an, dass der Host beim nächsten Check-in die Eigenschaften aktualisiert (asynchron)	`host_id`(erforderlich)
`mspbotsfleet_delete_host`	Entfernt den Host aus Fleet und löscht die Zuordnung (wenn fleetd nicht deinstalliert ist, registriert er sich erneut)	`host_id`(erforderlich)
`mspbotsfleet_claim_hosts`	Deklariert Kennungen und übernimmt passende herrenlose Hosts (idempotent, kann wiederholt aufgerufen werden, um nicht zugeordnete erneut zu versuchen)	`identifiers`(optional, Liste von Hostname/Seriennummer/UUID, max. 500 Einträge; weggelassen/leeres Array=nur zuvor deklarierte erneut versuchen)
`mspbotsfleet_release_host`	Gibt die Zuordnung eines Hosts zu diesem Mandanten auf, ohne den Host selbst zu löschen (idempotent)	`host_id`(erforderlich)

Die Hostliste wird vollständig abgerufen und dann im Speicher gefiltert/sortiert/aufgeteilt. Die Fleet-seitigen Daten werden 15 Sekunden zwischengespeichert, die Zuordnungsinformationen werden in Echtzeit aus der Datenbank abgefragt und nicht zwischengespeichert. claim_hosts gibt {claimed, waiting, rejected} zurück: waiting sind deklarierte, aber noch nicht in Fleet erschienene Hosts, rejected sind Kennungen, die bereits von einem anderen Mandanten deklariert wurden.

Skripte

Tool	Funktion	Parameter
`mspbotsfleet_list_scripts`	Listet die Skripte des Mandanten auf	`page`, `per_page`
`mspbotsfleet_get_script`	Ruft Skript-Details ab (einschließlich Inhalt)	`script_id`(erforderlich)
`mspbotsfleet_create_script`	Erstellt ein neues Skript (Dateiname muss auf `.sh`/`.ps1` enden). Nicht idempotent – wiederholter Aufruf erstellt mehrere Skripte	`name`(erforderlich), `contents`(erforderlich, ≤500KB)
`mspbotsfleet_update_script`	Ersetzt den Skriptinhalt (Dateiname kann nicht geändert werden)	`script_id`(erforderlich), `contents`(erforderlich)
`mspbotsfleet_delete_script`	Löscht das Skript (wirkt auf alle Hosts)	`script_id`(erforderlich)
`mspbotsfleet_run_script`	Führt das Skript auf dem Host aus	`script_id`(erforderlich), `host_id`(erforderlich), `sync`(Standard false, bei true warten ≤60s und Ergebnis zurückgeben)
`mspbotsfleet_get_script_result`	Fragt das Ausführungsergebnis ab (`exit_code` null bedeutet nicht zurückgemeldet)	`execution_id`(erforderlich)

create_script/update_script geben nur {id, name} zurück; Zeitstempel und andere Felder müssen über mspbotsfleet_get_script/mspbotsfleet_list_scripts abgefragt werden.

Gespeicherte Abfragen

Tool	Funktion	Parameter
`mspbotsfleet_list_queries`	Listet die Abfragen des Mandanten auf	`page`, `per_page`
`mspbotsfleet_get_query`	Ruft Abfrage-Details ab (einschließlich SQL)	`query_id`(erforderlich)
`mspbotsfleet_create_query`	Erstellt eine neue gespeicherte Abfrage (nur einzelne SELECT / WITH…SELECT erlaubt). Nicht idempotent – wiederholter Aufruf erstellt mehrere Abfragen	`name`(erforderlich), `sql`(erforderlich), `description`, `platform`(`darwin`/`windows`/`linux`)
`mspbotsfleet_update_query`	Aktualisiert die Abfrage (partiell, nur zu ändernde Felder übergeben)	`query_id`(erforderlich), `name`, `sql`, `description`, `platform`
`mspbotsfleet_delete_query`	Löscht die Abfrage und ihre Berichtsdaten	`query_id`(erforderlich)
`mspbotsfleet_run_query`	Führt die Abfrage in Echtzeit auf Hosts aus und wartet auf das Ergebnis (≤45s)	`query_id`(erforderlich), `host_ids`(optional, ≤50 Hosts, weggelassen=Standard die ersten 50 Hosts des Mandanten)

SQL-Validierungsregeln: Nur eine einzelne SELECT- oder WITH … SELECT-Anweisung erlaubt, abschließendes Semikolon wird automatisch entfernt, ein ; im Text wird direkt abgelehnt. Diese Validierung wird vom Backend durchgeführt, dieser Dienst validiert nicht erneut.

Schnellstart

Docker (empfohlen)

docker compose up --build

Der Server startet auf http://localhost:8080.

Lokal (uv)

uv sync
python -m mspbots_fleet_mcp

Health Check

curl http://localhost:8080/health
# {"status": "ok"}

Für den Health-Endpunkt sind keine Anmeldedaten erforderlich.

Authentifizierung

Jede Anfrage an /mcp muss die folgenden HTTP-Header enthalten (vom MCP-Aufrufer bereitgestellt – konsistent mit mspbots-agent-mcp / ticketqa-mcp):

Header	Typ	Erforderlich	Feldbeschreibung	Beispiel
`X-MSP-Token`	string	Erforderlich	Von Fleet Platform ausgestelltes Zugriffstoken (JWT-Bearer-Token). Dieser Dienst leitet es unverändert als `Authorization: Bearer <token>` an die Downstream-Anfrage weiter.	`X-MSP-Token: <jwt-bearer-token>`
`X-MSP-Tenant-Id`	string	Erforderlich	Mandantenkennung. Wird bei der Weiterleitung an die Downstream-API in den Header `X_Tenant_ID` umbenannt (der Mandant ist auch im JWT eingebettet).	`X-MSP-Tenant-Id: <tenant-id>`
`X-MSP-Host`	string	Erforderlich	Host, auf dem die Fleet-API läuft.	`X-MSP-Host: https://agent.mspbots.ai`

Fehlt einer der drei Header, wird 401 Unauthorized zurückgegeben.

Die Downstream-Fleet-API selbst gibt bei Authentifizierungsfehlern (fehlendes Token/falsche Signatur/unzureichende Rolle) einheitlich 403 zurück, nicht 401 – 401 tritt nur auf dieser Dienstebene auf (fehlender Gateway-Header).

Umgebungsvariablen

Variable	Standard	Beschreibung
`MCP_HTTP_PORT`	`8080`	Listening-Port
`MCP_HTTP_HOST`	`0.0.0.0`	Listening-Host

MCP-Endpunkt

POST http://localhost:8080/mcp

Verbinden Sie Ihren MCP-Client mit:

Transport: http (Streamable HTTP / SSE)
Header: X-MSP-Token, X-MSP-Tenant-Id, X-MSP-Host (alle erforderlich)

Testbeispiel

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 } }
  }'

⚠️ Dieses Repository ist öffentlich. Bitte schreiben Sie keine echten Token / Mandanten-IDs oder andere sensible Informationen in irgendeine Datei im Repository. Die obigen <token> / <tenant-id> sind nur Platzhalter.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Related MCP Connectors

jumpcloud-genaiOAuth
com.jumpcloud
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Cloud Platforms Security Developer Tools
2
https://mcp.jumpcloud.com/v1
Apideck MCP A
dev.apideck.mcp
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
Developer Tools
42
https://mcp.apideck.dev/mcp
JiZhiMCP A
io.github.alanwang100
Host any HTTP API as a standard MCP server; auto-distribute to 12+ mainstream agent platforms.
Developer Tools Agent Orchestration
121
https://mcp.xn--5kvtwv52d.com/mcp/gateway
MANDATE Credential Broker B
io.github.projetnanocorp
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
Security
111
https://mandate.nanocorp.app/mcp

Related MCP Servers

Teams Messenger MCP App
Communication Search RAG Systems
aech-ai
F
license
Not graded
quality
D
maintenance
A Model Context Protocol server that bridges Microsoft Teams with MCP-compatible clients (LLMs, agentic frameworks, CLI), enabling chat integration, message search, and event streaming without traditional REST API endpoints.
Updated 2 years ago (2025-04-21 16:47 UTC)
-
OpsLevel MCPofficial
Developer Tools Observability Monitoring
OpsLevel
A
license
Not graded
quality
F
maintenance
Model Context Protocol (MCP) server for OpsLevel
Updated 4 months ago (2026-07-10 16:15 UTC)
12
MIT
Device MCP Server
Multimedia Processing OS Automation
akshitsinha
A
license
Not graded
quality
D
maintenance
A Model Context Protocol (MCP) server for seamless integration with peripheral devices connected to your computer. Control, monitor, and manage hardware devices through a unified API.
Updated a year ago (2025-06-27 17:08 UTC)
5
MIT
Rancher MCP Server
Cloud Platforms Virtualization CI/CD & DevOps
mrostamii
A
license
B
quality
B
maintenance
Model Context Protocol (MCP) server for the Rancher ecosystem: multi-cluster Kubernetes, Harvester HCI (VMs, storage, networks), and Fleet GitOps.
Updated 14 days ago (2026-10-13 09:00 UTC)
10
12
Apache 2.0

mspbots-fleet-mcp

Wann Sie dies verwenden würden

Tools

Hosts

Skripte

Gespeicherte Abfragen

Schnellstart

Docker (empfohlen)

Lokal (uv)

Health Check

Authentifizierung

Umgebungsvariablen

MCP-Endpunkt

Testbeispiel

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Teams Messenger MCP App

OpsLevel MCPofficial

Device MCP Server

Rancher MCP Server