Tanium Gateway MCP

Tanium Gateway GraphQL API를 Model Context Protocol (MCP) 서버로 노출하는 Node.js 프로젝트입니다. Claude Desktop, Cursor, VS Code, Gemini CLI 등 MCP Host에서 자연어로 Tanium 자산·취약점·패치·배포 정보를 조회할 수 있습니다.

기능 개요

서버는 stdio 전송을 사용합니다. LLM은 MCP를 통해 Tool을 호출하고, 서버가 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

Tool 목록을 GUI로 확인하려면:

npm run inspect

(@modelcontextprotocol/inspector 사용)

MCP Host 설정 예시 (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 등 다른 Host 연동은 docs/Gemini_MCP_Host_연동_가이드.md를 참고하세요.

Tool 목록

Asset

Comply

Deploy

Discover

Integrity Monitor

Patch

Reporting

Threat Response

목록형 쿼리는 Tanium Gateway 공통 FieldFilter (path / op / value / any / filters)를 사용합니다. 문법은 MCP Resource 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로 생성합니다.

알려진 제한

다음 영역은 현재 Tool로 조회하지 않습니다. 상세는 Resource tanium://docs/known-limitations를 참고하세요.

• 자산 생애주기·EOL 예정일, 커스텀 중요도 등급

• 패치 SLA, 승인 워크플로, 자동 롤백

• Self Service Portal, MDM, Disk Encryption 등 별도 모듈 전역

라이선스

이 저장소에 라이선스 파일이 없으면, 업로드 시 사용 조건을 명시하는 것을 권장합니다.