Tanium Gateway MCP

Proyecto Node.js que expone la API GraphQL de Tanium Gateway como servidor Model Context Protocol (MCP). Permite consultar información de activos, vulnerabilidades, parches y despliegues de Tanium en lenguaje natural desde hosts MCP como Claude Desktop, Cursor, VS Code, Gemini CLI, etc.

Resumen de funciones

El servidor utiliza transporte stdio. El LLM invoca las herramientas a través de MCP y el servidor realiza las solicitudes GraphQL a Tanium Gateway en su lugar.

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

Requisitos

• Node.js 18 o superior (ES2022 / ESM)

• Endpoint GraphQL de Gateway en el entorno Tanium

• Token de API (se envía en la cabecera session)

Instalación

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

Variables de entorno

Cree un archivo .env en la raíz del proyecto. No confirme el token. .gitignore ya incluye .env.

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

Según la versión interna, el nombre de la cabecera de autenticación puede no ser session. Si recibe un 401, revise src/tanium-client.ts.

Compilación y ejecución

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

Para ejecutar TypeScript directamente durante el desarrollo:

npm run dev

Para ver la lista de herramientas en una interfaz gráfica:

npm run inspect

(usando @modelcontextprotocol/inspector)

Ejemplo de configuración de host MCP (Cursor)

En ~/.cursor/mcp.json o en el .cursor/mcp.json del proyecto:

{
  "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"
      }
    }
  }
}

Tras la configuración, ejecute npm run build una vez y vuelva a cargar el servidor MCP en Cursor.

Para la integración con otros hosts como Gemini CLI, VS Code Copilot, etc., consulte docs/Gemini_MCP_Host_연동_가이드.md.

Lista de herramientas

Asset

Comply

Deploy

Discover

Integrity Monitor

Patch

Reporting

Threat Response

Las consultas de tipo lista utilizan el FieldFilter común de Tanium Gateway (path / op / value / any / filters). La sintaxis también está disponible en el recurso MCP tanium://docs/field-filter-syntax.

Prompts

Estructura del proyecto

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

Antes de subir a GitHub

1. No confirme .env. (Ya está en .gitignore).

2. Si mcp.json o .cursor/mcp.json contienen tokens reales, no los incluya en el repositorio. Utilice solo marcadores de posición en los ejemplos.

3. dist/ y node_modules/ no se confirman. Se generan con npm install y npm run build tras clonar.

Limitaciones conocidas

Las siguientes áreas no se consultan actualmente con las herramientas. Consulte el recurso tanium://docs/known-limitations para más detalle.

• Ciclo de vida de activos, fechas de EOL, niveles de criticidad personalizados

• SLA de parches, flujos de aprobación, reversión automática

• Módulos globales separados como Self Service Portal, MDM, Disk Encryption, etc.

Licencia

Si este repositorio no incluye un archivo de licencia, se recomienda especificar las condiciones de uso al subirlo.