aantti/mcp-netbird

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

61 stars 10 forks 품질 66 트렌드 13Apache-2.0

Repository Install

Netbird를 위한 MCP 서버

개요

Netbird 용 모델 Context Protocol (MCP) 서버. 이 프로젝트는 Grafana Labs에 의해 Grafana에 대한 MCP Server에서 파생되며 동일한 Apache License 2.0에서 라이센스됩니다. Smithery를 통해 Claude Desktop용 Netbird MCP Server를 자동으로 설치하십시오. 서버는 다음과 같은 환경 변수를 요구합니다: - NETBIRD API TOKEN: Netbird API 토큰 - NETBIRD HOST (옵션): Netbird API 호스트 (기본은 api.netbird.io) 이 서버는 Netbird API를 사용하여 Netbird 네트워크에 대한 LLMs 정보를 제공합니다. 현재 도구에 대한 Select read-only Netbird API 리소스의 1:1 매핑입니다. - [x] Netbird API를 사용하여 구성 및 상태에 액세스 - [x] Configurable API endpoint - [x] Netbird API에 대한 안전한 토큰 기반 인증 1. 도구 (예 : 도구 / users.go)의 새로운 파일을 만들려면 기존 코드를 템플릿 2.로 사용하십시오. API 경로 및 응답을 새로운 파일에 추가 3. 도구 추가 func newServer() cmd/main.go

개요(AI 번역)

Netbird 용 모델 Context Protocol (MCP) 서버.

이 프로젝트는 Grafana Labs에 의해 Grafana에 대한 MCP Server에서 파생되며 동일한 Apache License 2.0에서 라이센스됩니다.

또한 MCP Go by Mark III Labs를 사용합니다.

주의: 이 프로젝트는 여전히 개발 중입니다.

설치

소스에서 설치

# 저장소를 복제

빌드 및 설치

GitHub에서 설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Netbird MCP Server를 자동으로 설치하십시오.

구성

서버는 다음과 같은 환경 변수를 요구합니다:

NETBIRD_API_TOKEN: Netbird API 토큰
NETBIRD_HOST (선택 사항): Netbird API 호스트 (기본은 api.netbird.io)

특징

이 서버는 Netbird API를 사용하여 Netbird 네트워크에 대한 LLMs 정보를 제공합니다. 현재 도구에 대한 Select read-only Netbird API 리소스의 1:1 매핑입니다.

[x] Netbird API를 사용하여 구성 및 상태에 액세스
[x] 구성 가능한 API 엔드포인트
[x] Netbird API에 대한 안전한 토큰 기반 인증

도구

| 도구 | 설명 | Netbird API | 인포메이션 | [T3] | 모든 동료 | 모든 피어 |

이 페이지는 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>"
         }
       }
     }
   }