aantti/mcp-netbird

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

61 stars 10 forks 品質 66 トレンド 13Apache-2.0

Repository Install

NetbirdのMCPサーバー

概要

Netbird用のモデルコンテキストプロトコル(MCP)サーバー。このプロジェクトは、Grafana Labs の Grafana の MCP Server から派生し、同じ Apache License 2.0 でライセンスされています。 Netbird MCP Server を、Smithery 経由で自動的に Claude デスクトップにインストールするには: サーバには、次の環境変数が必要です。 - NETBIRD API TOKEN:Netbird APIトークン - NETBIRD HOST(オプション):Netbird APIホスト(デフォルトはapi.netbird.ioです) このサーバーは、Netbird API を使用して、Netbird ネットワークに関する LLM 情報を提供します。現在、ツールに読み取り専用のNetbird APIリソースを選択するための1:1マッピングです。 - [x] Netbird API を使用して設定とステータス - [x] 設定可能な API エンドポイント - [x] Netbird API のセキュアなトークンベースの認証 1。ツール(例、ツール/users.go)で新しいファイルを作成すると、既存のコードをテンプレート2として使用できます。 API ルートを追加し、新しいファイル 3 に固有のレスポンスを追加します。 cmd/main.go で newServer() を func に追加する

概要（AI 翻訳）

Netbird用のモデルコンテキストプロトコル(MCP)サーバー。

このプロジェクトは、Grafana Labs の Grafana の MCP Server から派生し、同じ Apache License 2.0 でライセンスされています。

また、Mark III LabsのMCP Goを利用しています。

注意:このプロジェクトはまだ開発中です。

インストール

ソースからインストールする

リポジトリのクローン化

####ビルドとインストール

##GitHubからインストールする

##Smitheryでインストールする

Netbird MCP Server を、Smithery 経由で自動的に Claude デスクトップにインストールするには:

設定

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

[NETBIRD_API_TOKEN]: Netbird APIトークン
[NETBIRD_HOST (オプション): Netbird API ホスト (デフォルトは api.netbird.io))

##特徴

このサーバーは、Netbird API を使用して、Netbird ネットワークに関する LLM 情報を提供します。現在、ツールに読み取り専用のNetbird APIリソースを選択するための1:1マッピングです。

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

ツール

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Netbird MCP Server

A Model Context Protocol (MCP) server for Netbird.

This project is derived from the MCP Server for Grafana by Grafana Labs and is licensed under the same Apache License 2.0.

It also uses MCP Go by Mark III Labs.

Note: this project is still in development.

Installing

Installing from source

Clone the repository

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

Build and install

cd mcp-netbird && \
make install

Installing from GitHub

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

Installing via Smithery

To install Netbird MCP Server for Claude Desktop automatically via Smithery:

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

Configuration

The server requires the following environment variables:

NETBIRD_API_TOKEN: Your Netbird API token
NETBIRD_HOST (optional): The Netbird API host (default is api.netbird.io)

Features

This server uses the Netbird API to provide LLMs information about Netbird network. Currently it’s a 1:1 mapping of select read-only Netbird API resources to tools.

[x] Uses Netbird API to access configuration and status
[x] Configurable API endpoint
[x] Secure token-based authentication for Netbird API

Tools

Tool	Description	Netbird API
`list_netbird_peers`	All peers	List all Peers
`list_netbird_port_allocations`	All ingress ports for `peerId`	List all Port Allocations
`list_netbird_groups`	All groups	List all Groups
`list_netbird_policies`	All policies	List all Policies
`list_netbird_posture_checks`	All posture checks	List all Posture Checks
`list_netbird_networks`	All networks	List all Networks
`list_netbird_nameservers`	All nameserver groups	List all Nameserver Groups

Adding tools

To add new tools:

Create a new file in tools (e.g., tools/users.go), possibly use existing code as a template
Add API route and response specifics to the new file
Add the tool to func newServer() in cmd/main.go

Usage

Get your Netbird API token from the Netbird management console.

GitHub で README 全文を見る

インストール

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

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

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