tailscale mcp — Streamline network management with…

Pitch

Description

Comments

About this project

Tailscale MCP serves as a modern server providing seamless integration with Tailscale's CLI commands and REST API. This project enables automated network management and monitoring through a unified interface, making device management, network operations, and security controls simpler and more efficient.

Tailscale MCP is an innovative server implementation that seamlessly integrates with Tailscale's command-line interface (CLI) and REST API, providing a standardized interface for automated network management and monitoring. This modern server, built on the Model Context Protocol (MCP), facilitates effective device and network operations, empowering users to enhance their network management capabilities.

Key Features

Device Management: Efficiently list, authorize, and deauthorize devices within the Tailscale network.
Network Operations: Easily connect or disconnect from the network, manage routes, and monitor network status in real time.
Security Controls: Maintain control over Access Control Lists (ACLs), device tags, and network lock settings, ensuring robust security for the network.
Modern Architecture: Built with TypeScript and Zod validation, ensuring a modular tool system that is both efficient and scalable.
CLI and API Integration: Directly integrates with Tailscale's CLI commands and provides REST API support for advanced functionalities.

Packages Available

NPM: @hexsleeves/tailscale-mcp-server
Docker Hub: hexsleeves/tailscale-mcp-server
GitHub Container Registry: ghcr.io/hexsleeves/tailscale-mcp-server

Usage Examples

Run Tailscale MCP server directly using NPX:

# Method 1: Explicit package syntax (most reliable)
npx --package=@hexsleeves/tailscale-mcp-server tailscale-mcp-server

Launch Tailscale MCP using Docker:

# Pull and run from Docker Hub
docker run -d \
  --name tailscale-mcp \
  -e TAILSCALE_API_KEY=your_api_key \
  -e TAILSCALE_TAILNET=your_tailnet \
  hexsleeves/tailscale-mcp-server:latest

Configuration

Easily integrate Tailscale MCP with your software environment by configuring necessary environment variables:

export TAILSCALE_API_KEY="your-api-key"
export TAILSCALE_TAILNET="your-tailnet"

Additionally, Tailscale MCP features a range of tools for device management, network operations, security configurations, and system diagnostics, making it a comprehensive solution for managing Tailscale networks. Development of new features and tools is encouraged, following guidelines for modular architecture and TypeScript compliance.