Tanium Gateway MCP

Tanium Gateway GraphQL APIをModel Context Protocol (MCP)サーバーとして公開するNode.jsプロジェクトです。Claude Desktop、Cursor、VS Code、Gemini CLIなどのMCPホストから、自然言語で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）

• Tanium環境のGateway GraphQLエンドポイント

• APIトークン（sessionヘッダーで送信）

インストール

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

環境変数

プロジェクトルートに.envファイルを作成します。トークンはコミットしないでください。 .gitignoreに.envが含まれています。

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

ツール一覧をGUIで確認する場合:

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を一度実行し、CursorでMCPサーバーを再読み込みしてください。

Gemini CLI、VS Code Copilotなど他のホスト連携はdocs/Gemini_MCP_Host_연동_가이드.mdを参照してください。

ツール一覧

Asset

Comply

Deploy

Discover

Integrity Monitor

Patch

Reporting

Threat Response

一覧型クエリはTanium Gateway共通のFieldFilter（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など別モジュール全体

ライセンス

このリポジトリにライセンスファイルがない場合は、アップロード時に利用条件を明記することを推奨します。