aantti/mcp-netbird

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

61 stars 10 forks Качество 66 Тренд 13Apache-2.0

Repository Install

MCP сервер для Netbird

Обзор

Сервер Model Context Protocol (MCP) для Netbird. Данный проект является производным от MCP Server for Grafana компании Grafana Labs и лицензируется по той же лицензии Apache 2.0. Для автоматической установки Netbird MCP Server для Claude Desktop через Smithery: Сервер требует следующих переменных среды: - NETBIRD API TOKEN: Ваш токен API Netbird - NETBIRD HOST (необязательно): хост API Netbird (по умолчанию api.netbird.io) Этот сервер использует API Netbird для предоставления LLM-информации о сети Netbird. В настоящее время это отображение 1:1 избранных ресурсов API Netbird для чтения. - [x] Использует API Netbird для доступа к конфигурации и статусу - [x] Конфигурируемая конечная точка API - [x] Безопасная аутентификация на основе токенов для Netbird API 1.Создать новый файл в инструментах (например, tools/users.go), возможно использовать существующий код в качестве шаблона 2. Добавьте API-маршрут и спецификацию ответа к новому файлу 3. Добавить инструмент в func newServer() в cmd/main.go

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP) для Netbird.

Данный проект является производным от MCP Server for Grafana компании Grafana Labs и лицензируется по той же лицензии Apache 2.0.

Также используется MCP Go от Mark III Labs.

Примечание: проект находится в разработке.

##Установка

###Установка из источника

Клонировать репозиторий

####Строить и установить

###Установка с GitHub

###Установка через Smithery

Для автоматической установки Netbird MCP Server для Claude Desktop через Smithery:

Конфигурация

Сервер требует следующих переменных среды:

[[Т0]]: Токен Netbird API
NETBIRD_HOST (необязательно): хост API Netbird (по умолчанию api.netbird.io)

Особенности

Этот сервер использует API Netbird для предоставления LLM-информации о сети Netbird. В настоящее время это отображение 1:1 избранных ресурсов API Netbird для чтения.

Использует Netbird API для доступа к конфигурации и статусу Конфигурируемая конечная точка API

[x] Безопасная аутентификация на основе токенов для Netbird API

Инструменты

Обсуждение Netbird API [править править код] [[Т3]] Все сверстники [Перечислите всех пэров]

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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.

Открыть полный README на GitHub

Установка

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>"
         }
       }
     }
   }