使用说明
基本能力
产品定位
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