Netbird MCP Server

Netbird MCP サーバー

Netbird 用の Model Context Protocol（MCP）サーバーです。

このプロジェクトは、Grafana Labs による Grafana 用 MCP サーバーをベースにしており、同じ Apache License 2.0 の下でライセンスされています。

また、Mark III Labs による MCP Go も使用しています。

注：このプロジェクトは現在も開発中です。

インストール

ソースからインストール

リポジトリをクローン

git clone https://github.com/aantti/mcp-netbird

ビルドしてインストール

cd mcp-netbird && \
make install

GitHub からインストール

go install github.com/aantti/mcp-netbird/cmd/mcp-netbird@latest

Smithery 経由でインストール

Smithery 経由で Claude Desktop 用の Netbird MCP Server を自動的にインストールするには：

npx -y @smithery/cli install @aantti/mcp-netbird --client claude

設定

サーバーには次の環境変数が必要です。

• NETBIRD_API_TOKEN：Netbird API トークン
• NETBIRD_HOST（任意）：Netbird API ホスト（デフォルトは api.netbird.io）

機能

このサーバーは Netbird API を使用して、LLM に Netbird ネットワークの情報を提供します。現在は、選択した読み取り専用の Netbird API リソースをツールに 1 対 1 で対応させています。

• Netbird API を使用して設定とステータスにアクセス
• API エンドポイントを設定可能
• Netbird API のトークンベースのセキュアな認証

ツール

ツール	説明	Netbird API
list_netbird_peers	すべてのピア	すべてのピアを一覧表示
list_netbird_port_allocations	peerId のすべてのイングレスポート	すべてのポート割り当てを一覧表示
list_netbird_groups	すべてのグループ	すべてのグループを一覧表示
list_netbird_policies	すべてのポリシー	すべてのポリシーを一覧表示
list_netbird_posture_checks	すべてのポスチャーチェック	すべてのポスチャーチェックを一覧表示
list_netbird_networks	すべてのネットワーク	すべてのネットワークを一覧表示
list_netbird_nameservers	すべてのネームサーバーグループ	すべてのネームサーバーグループを一覧表示

ツールの追加

新しいツールを追加するには：

1. tools に新しいファイルを作成します（例：tools/users.go）。既存のコードをテンプレートとして使用できます
2. API ルートとレスポンスの詳細を新しいファイルに追加します
3. cmd/main.go の func newServer() にツールを追加します

使い方

1. Netbird 管理コンソールから Netbird API トークンを取得します。

2. 上記のインストール方法のいずれかを使用して、mcp-netbird バイナリをインストールします。バイナリが PATH に含まれていることを確認してください。

3. サーバー設定をクライアント設定ファイルに追加します。たとえば、Codeium Windsurf の場合は、~/.codeium/windsurf/mcp_config.json に次の設定を追加します。

   {
     "mcpServers": {
       "netbird": {
         "command": "mcp-netbird",
         "args": [],
         "env": {
           "NETBIRD_API_TOKEN": "<your-api-token>"
         }
       }
     }
   }
   

Claude Desktop に同様の設定を追加する方法については、こちらをご覧ください。

注：Claude Desktop のログに [netbird] [error] spawn mcp-netbird ENOENT のようなメッセージが表示される場合は、mcp-netbird のフルパスを指定する必要があります。macOS の Claude Logs は ~/Library/Logs/Claude にあります。

4. 「Netbird のピア、グループ、ポリシーについて説明してもらえますか？」のような質問をしてみてください。

Docker

イメージをビルドしてタグ付けします：

docker build -t mcp-netbird-sse:v1 -f Dockerfile.sse .

イメージを実行します：

docker run --name mcp-netbird -p 8001:8001 -e NETBIRD_API_TOKEN=<your-api-token> mcp-netbird-sse:v1

ToolHive

ToolHive（thv）は、MCP サーバーのデプロイと管理を簡素化するために設計された軽量ユーティリティです。

ToolHive を使用して、以下のように Netbird MCP をデプロイして実行できます。

1. ToolHive README の説明に従って thv をインストールします。

2. thv のシークレットに Netbird API トークンを追加します。

thv secret set netbird

3. 上記の Docker セクション（#docker）の説明に従って SSE イメージをビルドします。

4. thv run を使用してポート 8080 で Netbird MCP を起動します。

thv run --secret netbird,target=NETBIRD_API_TOKEN --transport sse --name thv-mcp-netbird --port 8080 --target-port 8001 mcp-netbird-sse:v1

5. サーバーを停止するときは、以下を使用します。

thv stop thv-mcp-netbird

開発

コントリビューションを歓迎します。ご提案や改善点があれば、issue を作成するか、プルリクエストを送信してください。

このプロジェクトは Go で記述されています。ご利用のプラットフォーム向けの手順に従って Go をインストールしてください。

サーバーを手動で実行するには、以下を使用します。

export NETBIRD_API_TOKEN=your-token && \
go run cmd/mcp-netbird/main.go

または、SSE モードの場合：

export NETBIRD_API_TOKEN=your-token && \
go run cmd/mcp-netbird/main.go --transport sse --sse-address :8001

デバッグ

MCP Inspector は、MCP サーバーのテストとデバッグに使用できるインタラクティブな開発者向けツールです。詳しくはこちらをご覧ください。

MCP Inspector を起動する方法は以下のとおりです。

export NETBIRD_API_TOKEN=your-token && \
npx @modelcontextprotocol/inspector

その後、Netbird MCP Server は stdio または SSE のいずれかのトランスポートタイプでテストできます。stdio の場合は、UI で mcp-netbird のフルパスを指定してください。

テスト

TODO：テストを追加する

Lint

コードを lint するには、以下を実行します。

make lint

ライセンス

このプロジェクトはApache License, Version 2.0の下でライセンスされています。

このプロジェクトには、Grafana Labs（https://grafana.com/）で開発されたソフトウェアが含まれています。

このプロジェクトには、Mark III Labs（https://github.com/mark3labs/mcp-go）で開発されたソフトウェアが含まれています。