Tanium Gateway MCP

Ein Node.js-Projekt, das die Tanium Gateway GraphQL API als Model Context Protocol (MCP)-Server bereitstellt. Von MCP-Hosts wie Claude Desktop, Cursor, VS Code, Gemini CLI usw. können Tanium-Asset-, Schwachstellen-, Patch- und Bereitstellungsinformationen in natürlicher Sprache abgefragt werden.

Funktionsübersicht

Der Server verwendet die stdio-Übertragung. Das LLM ruft Tools über MCP auf, und der Server stellt die Tanium Gateway GraphQL-Anfragen stellvertretend.

MCP Host (Claude / Cursor / Gemini …)
        │  MCP (stdio)
        ▼
tanium-gateway-mcp
        │  GraphQL (session 헤더)
        ▼
Tanium Gateway (`/plugin/products/gateway/graphql`)

Related MCP server: Purple AI MCP Server

Voraussetzungen

• Node.js 18 oder höher (ES2022 / ESM)

• Gateway-GraphQL-Endpunkt in der Tanium-Umgebung

• API-Token (über den session-Header übergeben)

Installation

git clone <이 저장소 URL>
cd tanium-gateway-mcp_dev   # 또는 클론한 디렉터리 이름
npm install

Umgebungsvariablen

Erstellen Sie eine .env-Datei im Projektstamm. Committen Sie das Token nicht. .env ist in .gitignore enthalten.

TANIUM_BASE_URL=https://your-tanium-instance.example.com
TANIUM_GRAPHQL_PATH=/plugin/products/gateway/graphql
TANIUM_API_TOKEN=your-api-token

Je nach interner Version kann der Authentifizierungs-Header anders als session heißen. Bei einem 401 prüfen Sie src/tanium-client.ts.

Build und Ausführung

npm run build          # TypeScript → dist/
node dist/index.js     # stdio MCP 서버 (Host가 spawn하는 방식과 동일)

Um TypeScript während der Entwicklung direkt auszuführen:

npm run dev

Um die Tool-Liste in einer GUI anzuzeigen:

npm run inspect

(mit @modelcontextprotocol/inspector)

Beispiel für die MCP-Host-Konfiguration (Cursor)

~/.cursor/mcp.json oder .cursor/mcp.json im Projekt:

{
  "mcpServers": {
    "tanium-gateway": {
      "command": "node",
      "args": ["/절대경로/tanium-gateway-mcp_dev/dist/index.js"],
      "env": {
        "TANIUM_BASE_URL": "https://your-tanium-instance.example.com",
        "TANIUM_GRAPHQL_PATH": "/plugin/products/gateway/graphql",
        "TANIUM_API_TOKEN": "your-api-token"
      }
    }
  }
}

Führen Sie nach der Konfiguration einmal npm run build aus und laden Sie den MCP-Server in Cursor neu.

Für die Integration mit anderen Hosts wie Gemini CLI, VS Code Copilot usw. siehe docs/Gemini_MCP_Host_연동_가이드.md.

Tool-Liste

Asset

Comply

Deploy

Discover

Integrity Monitor

Patch

Reporting

Threat Response

Listenabfragen verwenden den gemeinsamen FieldFilter von Tanium Gateway (path / op / value / any / filters). Die Syntax ist auch in der MCP-Ressource tanium://docs/field-filter-syntax verfügbar.

Prompts

Projektstruktur

src/
  index.ts                 # MCP 서버 엔트리 (stdio)
  tanium-client.ts         # GraphQL 클라이언트
  resources.ts             # MCP Resources
  prompts.ts               # MCP Prompts
  tools/                   # 모듈별 Tool
    asset.ts
    comply.ts
    deploy.ts
    discover.ts
    integrityMonitor.ts
    patch.ts
    reporting.ts
    threatResponse.ts
docs/
  Tanium_Gateway_MCP_구축_가이드.md

Vor dem Hochladen auf GitHub

1. Committen Sie .env nicht. (bereits in .gitignore enthalten)

2. Legen Sie mcp.json bzw. .cursor/mcp.json nicht ins Repository, wenn echte Tokens enthalten sind. Verwenden Sie in Beispielen nur Platzhalter.

3. dist/ und node_modules/ werden nicht committet. Sie werden nach dem Klonen per npm install und npm run build erzeugt.

Bekannte Einschränkungen

Die folgenden Bereiche werden derzeit nicht über Tools abgefragt. Details finden Sie in der Ressource tanium://docs/known-limitations.

• Asset-Lebenszyklus, geplante EOL-Termine, benutzerdefinierte Kritikalitätsstufen

• Patch-SLA, Genehmigungsworkflows, automatisches Rollback

• Globale Einstellungen separater Module wie Self Service Portal, MDM, Disk Encryption

Lizenz

Wenn dieses Repository keine Lizenzdatei enthält, wird empfohlen, beim Hochladen die Nutzungsbedingungen anzugeben.