Netbird MCP Server
2025.05.03
61
Go网络管理API 服务其它
Netbird MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，专为 Netbird 网络服务设计。它通过 Netbird API 提供对网络配置和状态的访问，支持多种安装方式和配置选项。
View on GitHub
Overview
基本能力
产品定位
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