Netbird MCP Server

Netbird MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,专为 Netbird 网络服务设计。它通过 Netbird API 提供对网络配置和状态的访问,支持多种安装方式和配置选项。

  • by shinycongre
  • 61 星标
  • 更新于
在 GitHub 查看 shinycongre/mcp-netbird

使用说明

基本能力

产品定位

Netbird MCP Server 是一个用于 Netbird 网络的 MCP 服务器,提供对 Netbird 网络配置和状态的访问。

核心功能

  • 使用 Netbird API 访问配置和状态
  • 可配置的 API 端点
  • 基于令牌的安全认证

适用场景

  • 需要查询 Netbird 网络状态的场景
  • 需要管理 Netbird 网络配置的场景

工具列表

工具 描述
list_netbird_peers 列出所有对等节点
list_netbird_port_allocations 列出指定对等节点的所有入口端口
list_netbird_groups 列出所有组
list_netbird_policies 列出所有策略
list_netbird_posture_checks 列出所有姿势检查
list_netbird_networks 列出所有网络
list_netbird_nameservers 列出所有名称服务器组

常见问题解答

  • 如果看到 [netbird] [error] spawn mcp-netbird ENOENT 错误,需要指定 mcp-netbird 的完整路径

使用教程

使用依赖

  • 需要安装 Go 语言环境

安装教程

从源代码安装

git clone https://github.com/shinycongre/mcp-netbird
cd mcp-netbird && \
make install

从 GitHub 安装

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

通过 Smithery 安装

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

调试方式

运行服务器

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

使用 MCP Inspector 调试

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