Tanium Gateway MCP

Node.js-проект, который предоставляет Tanium Gateway GraphQL API в виде сервера Model Context Protocol (MCP). В MCP-хостах, таких как Claude Desktop, Cursor, VS Code, Gemini CLI и других, можно запрашивать информацию об активах, уязвимостях, патчах и развёртывании Tanium на естественном языке.

Обзор функций

Сервер использует транспорт stdio. LLM вызывает инструменты через MCP, а сервер выполняет запросы к Tanium Gateway GraphQL от его имени.

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

Требования

• Node.js 18 или выше (ES2022 / ESM)

• Конечная точка Gateway GraphQL в среде Tanium

• API-токен (передаётся в заголовке session)

Установка

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

Переменные окружения

Создайте файл .env в корне проекта. Не коммитьте токен. .env включён в .gitignore.

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

В зависимости от версии внутри компании имя заголовка аутентификации может отличаться от session. При ошибке 401 проверьте src/tanium-client.ts.

Сборка и запуск

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

Чтобы сразу запустить TypeScript в процессе разработки:

npm run dev

Чтобы просмотреть список инструментов в графическом интерфейсе:

npm run inspect

(с использованием @modelcontextprotocol/inspector)

Пример настройки MCP-хоста (Cursor)

~/.cursor/mcp.json или .cursor/mcp.json проекта:

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

После настройки один раз выполните npm run build и перезагрузите MCP-сервер в Cursor.

Инструкции по подключению других хостов, таких как Gemini CLI, VS Code Copilot и др., см. в docs/Gemini_MCP_Host_연동_가이드.md.

Список инструментов

Asset

Comply

Deploy

Discover

Integrity Monitor

Patch

Reporting

Threat Response

Запросы со списками используют общий FieldFilter Tanium Gateway (path / op / value / any / filters). Синтаксис также доступен в ресурсе MCP tanium://docs/field-filter-syntax.

Prompts

Структура проекта

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

Перед публикацией на GitHub

1. Не коммитьте .env. (уже в .gitignore)

2. Не помещайте в репозиторий mcp.json, .cursor/mcp.json, если в них есть реальные токены. Используйте только плейсхолдеры в примерах.

3. dist/ и node_modules/ не коммитятся. Они создаются после клонирования с помощью npm install и npm run build.

Известные ограничения

Следующие области в настоящее время не запрашиваются инструментами. Подробности см. в ресурсе tanium://docs/known-limitations.

• Жизненный цикл активов, даты EOL, пользовательские классы важности

• SLA патчей, рабочие процессы утверждения, автоматический откат

• Глобальные настройки отдельных модулей, таких как Self Service Portal, MDM, Disk Encryption и др.

Лицензия

Если в этом репозитории нет файла лицензии, рекомендуется указать условия использования при загрузке.