TAK Server MCP (Model Context Protocol)

A Model Context Protocol (MCP) server for integrating TAK Server with AI systems, enabling geospatial-aware deep research and analysis capabilities.

🚀 Features

Multi-Transport Support

• stdio - Standard input/output for CLI integration
• HTTP+SSE - Server-Sent Events for web integration
• WebSocket - Real-time bidirectional communication

Complete Tool Suite (11 Tools)

📍 Geospatial Operations

• tak_spatial_query - Query entities within geographic areas
• tak_calculate_distance - Distance calculations with travel time estimates
• tak_find_nearest - Find nearest entities with bearings
• tak_create_geofence - Create geofenced areas with alerts
• tak_analyze_movement - Track movements and detect anomalies

📡 Real-time Operations

• tak_get_cot_events - Retrieve Cursor on Target events
• tak_send_cot_event - Send CoT messages
• tak_subscribe_events - Subscribe to live event streams
• tak_get_entities - Get current entity states

🚨 Mission & Emergency

• tak_get_missions - List and manage missions
• tak_get_alerts - Retrieve and filter alerts
• tak_send_emergency - Send emergency broadcasts
• tak_manage_data_packages - Upload/download data packages

Advanced Features

• 🔐 Multiple authentication methods (OAuth 2.0, API tokens, certificates)
• 📊 H3 hexagonal indexing for spatial queries
• 🗺️ MGRS coordinate conversion
• ⚡ Real-time WebSocket subscriptions
• 💾 Intelligent caching with TTL
• 🔍 Comprehensive error handling

📋 Prerequisites

• Node.js >= 18.0.0
• TAK Server instance (one of):
  • TAK Server (Official)
  • FreeTAKServer (Open Source)
  • taky (Lightweight, CoT only)

🛠️ Installation

Using NPM

npm install @skyfi/tak-server-mcp

From Source

git clone https://github.com/skyfi/tak-server-mcp.git
cd tak-server-mcp
npm install
npm run build

Using Docker

docker pull skyfi/tak-server-mcp:latest

⚙️ Configuration

Environment Variables

# TAK Server Connection
TAK_SERVER_URL=https://your-tak-server.com
TAK_SERVER_API_TOKEN=your-api-token
TAK_SERVER_CLIENT_CERT=/path/to/cert.pem
TAK_SERVER_CLIENT_KEY=/path/to/key.pem

# MCP Configuration
MCP_TRANSPORT=stdio
MCP_PORT=3000
MCP_AUTH_ENABLED=false

Configuration File

Create a config.json:

{
  "takServer": {
    "url": "https://your-tak-server.com",
    "apiToken": "your-token",
    "verifySsl": true
  },
  "mcp": {
    "transport": "stdio",
    "port": 3000
  },
  "tools": {
    "enabledTools": ["tak_get_cot_events", "tak_spatial_query"]
  }
}

🚀 Quick Start

1. With Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "tak-server": {
      "command": "npx",
      "args": ["@skyfi/tak-server-mcp"],
      "env": {
        "TAK_SERVER_URL": "https://your-tak-server.com",
        "TAK_SERVER_API_TOKEN": "your-token"
      }
    }
  }
}

2. With Docker

docker run -it --rm \
  -e TAK_SERVER_URL=https://your-tak-server.com \
  -e TAK_SERVER_API_TOKEN=your-token \
  skyfi/tak-server-mcp:latest

3. Command Line

# Install globally
npm install -g @skyfi/tak-server-mcp

# Run with environment variables
TAK_SERVER_URL=https://your-tak-server.com \
TAK_SERVER_API_TOKEN=your-token \
tak-server-mcp

# Or with config file
tak-server-mcp --config ./config.json

📚 Usage Examples

Calculate Distance Between Points

{
  "tool": "tak_calculate_distance",
  "arguments": {
    "from": { "coordinate

... [View full README on GitHub](https://github.com/jfuginay/tak-server-mcp#readme)