Netbird MCP Server
2025.04.16
28
Go网络管理节点监控其它
mcp-netbird 是一个基于 Model Context Protocol (MCP) 的服务器，专为 Netbird 网络管理设计。它提供了对 Netbird 网络中节点、组和策略的详细查询功能，支持通过 API 令牌进行安全认证，并允许配置自定义 API 端点。该项目目前仍在开发中。
View on GitHub
Overview
基本能力
产品定位
mcp-netbird 是一个用于 Netbird 网络的 MCP 服务器，提供网络节点、组和策略的管理和查询功能。
核心功能
- 列出 Netbird 网络中的节点，包括连接状态、位置信息、系统详情和组归属
- 列出 Netbird 网络中的所有组
- 列出 Netbird 网络中的所有策略
- 可配置的 API 端点
- 基于令牌的安全认证
适用场景
- Netbird 网络管理
- 网络节点监控
- 网络策略分析
工具列表
| 工具 | 类别 | 描述 |
|---|---|---|
list_netbird_peers |
节点 | 列出 Netbird 网络中的所有节点 |
list_netbird_groups |
组 | 列出 Netbird 网络中的所有组 |
list_netbird_policies |
策略 | 列出 Netbird 网络中的所有策略 |
常见问题解答
- 如果遇到类似
[netbird] [error] spawn mcp-netbird ENOENT的错误，需要指定mcp-netbird的完整路径 - 在 macOS 上，Claude 日志位于
~/Library/Logs/Claude
使用教程
使用依赖
- 需要安装 Go 语言环境
- 需要 Netbird API 令牌
安装教程
从源代码安装
git clone https://github.com/aantti/mcp-netbird
cd mcp-netbird && \
make install
从 GitHub 安装
go install github.com/aantti/mcp-netbird/cmd/mcp-netbird@latest
调试方式
手动运行服务器
export NETBIRD_API_TOKEN=your-token && \
go run cmd/mcp-netbird/main.go
在 SSE 模式下运行
export NETBIRD_API_TOKEN=your-token && \
go run cmd/mcp-netbird/main.go --transport sse --sse-address :8001
使用 MCP Inspector 调试
export NETBIRD_API_TOKEN=your-token && \
npx @modelcontextprotocol/inspector