Tailscale MCP Server

🚀 Tailscale モデルコンテキストプロトコル (MCP) サーバー

Tailscale モデルコンテキストプロトコル (MCP) サーバーは、Tailscale ネットワークへの読み取り専用アクセスを提供するツールです。MCP リモートプロシージャコール (RPC) インターフェースを通じて大規模言語モデルとやり取りします。このサーバーを使用すると、ユーザーはネットワーク状態やデバイス情報を照会できますが、設定の変更はできません。

🚀 クイックスタート

Tailscale モデルコンテキストプロトコル (MCP) サーバーを使い始めるには、以下のインストール要求を満たす必要があります。

✨ 主な機能

核心機能

• ネットワーク状態照会：Tailscale ネットワーク内のすべてのデバイス、オンライン状態、および IP アドレスを確認できます。
• 詳細情報検索：特定のデバイスの設定詳細（DERP サーバーの位置、バージョン情報など）を取得できます。
• DNS および NAT 設定：MagicDNS と UPnP ポートマッピングの有効状態を確認できます。

セキュリティ機能

• 読み取り専用アクセス：サーバーはネットワーク情報の照会機能のみを提供し、書き込み操作は実行できません。
• ホワイトリストコマンド：事前定義された安全なコマンドセットのみを実行できます。
• ユーザー権限：すべてのコマンドは現在のユーザーの権限で実行され、通常の CLI 使用と同じセキュリティレベルが保証されます。

📦 インストール

インストール要件

• オペレーティングシステム：macOS、Linux（Windows の WSL 環境を含む）をサポートしています。
• Go 言語：Go 1.20 以上のバージョンが必要です。
• Tailscale CLI：インストールされ、ターミナルで直接実行できる必要があります。

📚 ドキュメント

セキュリティに関する注意事項

1. アクセス制限：このサーバーは読み取り専用アクセスのみを提供し、ネットワーク設定には一切の変更を加えません。
2. コマンド制御：検証済みの Tailscale コマンドのみを実行でき、危険な操作は厳禁です。
3. ユーザー権限：すべての操作は現在のユーザーの権限で実行され、直接 CLI を使用する場合と同じセキュリティが保証されます。

トラブルシューティング

Claude Desktop でサーバーが表示されない場合

1. 設定ファイルで指定された実行可能ファイルのパスが正しいことを確認してください。
2. Tailscale CLI がインストールされ、ターミナルで実行できることを確認してください。
3. ログファイルを確認して詳細な情報を取得してください。
   • macOS: ~/Library/Logs/Claude/mcp*.log
   • Windows: %APPDATA%\Claude\logs\mcp*.log

コマンドの実行に失敗した場合

1. コマンドが許可されたホワイトリストに含まれていることを確認してください。
2. Tailscale が正しく設定され、接続されていることを確認してください。
3. 同じコマンドを直接 Tailscale CLI で実行して、機能が正常に動作することを確認してください。

開発情報

このサーバーは mcp-go ライブラリをベースに構築されています。拡張または変更する場合は、以下の手順に従ってください。

1. コードリポジトリをクローンします。
2. 必要な変更を加えます。
3. go build を使用してプロジェクトをビルドします。
4. Claude Desktop または他の MCP クライアントを使用してテストします。

貢献ガイド

どんな貢献も歓迎します！自由に質問を投稿したり、プルリクエストを送信したりしてください。

📄 ライセンス

MIT ライセンス