Netbird MCP Server

MCPAI代理

提供方 aantti · 包名 @smithery/cli

AI代理 stdio · 本地进程 Token 社区 / 第三方 Claude DesktopClaudeWindsurf
查看接入方式

Netbird MCP服务器是一个基于Model Context Protocol(MCP)的服务,用于通过Netbird API访问和管理Netbird网络的配置和状态信息。

一句话选型结论

按资料字段整理

Netbird MCP Server 属于AI代理类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude Desktop、Claude、Windsurf,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权Token 部署方式支持远程部署
GitHub 星标 48 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

网络管理Go本地部署API工具MCP协议Netbird集成

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
npx -y @smithery/cli install @aantti/mcp-netbird --client claude

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Windsurf,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Netbird MCP Server当前 未标注 stdio · 本地进程 支持远程部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方aantti上游标注的维护方 aantti
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@smithery/cli · Node.js本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

4.9 KB
来自项目仓库与上游目录的原文,未做删改

Netbird MCP服务器

A. 模型上下文协议 (MCP)服务器 网鸟.

该项目源自 Grafana的MCP服务器 由Grafana Labs开发,并根据相同的Apache许可证2.0获得许可。

它还使用 MCP Go Mark III实验室。

注:该项目仍在开发中。

安装

从源代码安装

克隆存储库```bash

git clone https://github.com/aantti/mcp-netbird


#### 构建和安装```bash
cd mcp-netbird && \
make install

从GitHub安装```bash

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


### 通过Smithery安装

通过以下方式自动安装克劳德桌面版Netbird MCP服务器 史密瑟里:```bash
npx -y @smithery/cli install @aantti/mcp-netbird --client claude

配置

服务器需要以下环境变量:

  • NETBIRD_API_TOKEN:您的Netbird API代币
  • NETBIRD_HOST (可选):Netbird API主机(默认为 api.netbird.io)

特性

该服务器使用Netbird API提供有关Netbird网络的LLM信息。目前,它是一个1:1的选择只读Netbird API资源到工具的映射。

  • [x] 使用Netbird API访问配置和状态
  • [x] 可配置的API端点
  • [x] Netbird API基于令牌的安全身份验证

工具

工具 说明 Netbird API
list_netbird_peers 所有同行 列出所有对等方
list_netbird_port_allocations 所有入口端口 peerId 列出所有端口分配
list_netbird_groups 所有组 列出所有组
list_netbird_policies 所有政策 列出所有政策
list_netbird_posture_checks 所有姿势检查 列出所有姿势检查
list_netbird_networks 所有网络 列出所有网络
list_netbird_nameservers 所有名称服务器组 列出所有名称服务器组

添加工具

要添加新工具,请执行以下操作:

  1. 在中创建新文件 tools (例如。, tools/users.go),可能使用现有代码作为模板
  2. 将API路由和响应细节添加到新文件中
  3. 将工具添加到 func newServer() 在……里面 cmd/main.go

用法

  1. 得到你的 Netbird API代币 从Netbird管理控制台。

  2. 安装 mcp-netbird 使用上述安装方法之一的二进制文件。确保二进制文件在您的PATH中。

  3. 将服务器配置添加到客户端配置文件中。例如,对于Codeium Windsurf,添加以下内容 ~/.codeium/windsurf/mcp_config.json:```json
    {
    "mcpServers": {
    "netbird": {
    "command": "mcp-netbird",
    "args": [],
    "env": {
    "NETBIRD_API_TOKEN": ""
    }
    }
    }
    }


有关如何向Claude Desktop添加类似配置的更多信息,请参阅 这里.

> 注意:如果你看到一些类似的东西 `[netbird] [error] spawn mcp-netbird ENOENT` 在Claude Desktop日志中,您需要指定以下内容的完整路径 `mcp-netbird`。在macOS上,Claude日志位于 `~/Library/Logs/Claude`.

4. 试着问这样的问题:“你能向我解释一下我的Netbird同行、团体和政策吗?”

## 码头工人

构建一个图像并标记它:```bash
docker build -t mcp-netbird-sse:v1 -f Dockerfile.sse .

运行映像:```bash
docker run --name mcp-netbird -p 8001:8001 -e NETBIRD_API_TOKEN= mcp-netbird-sse:v1


## ToolHive

ToolHive (thv)是一个轻量级的实用程序,旨在简化MCP服务器的部署和管理。

您可以使用ToolHive部署和运行Netbird MCP,如下所示:

1. 安装 `thv` 如所述 ToolHive自述.

1. 将Netbird API令牌添加到 `thv` 秘密:```bash
thv secret set netbird
  1. 按照Docker部分中的描述构建SSE映像 上方

  2. 使用启动Netbird MCP thv run 在端口8080上:```bash
    thv run --secret netbird,target=NETBIRD_API_TOKEN --transport sse --name thv-mcp-netbird --port 8080 --target-port 8001 mcp-netbird-sse:v1


5. 当您想停止服务器时,请使用:```bash
thv stop thv-mcp-netbird

发展

欢迎投稿!如果您有任何建议或改进,请打开问题或提交拉取请求。

这个项目是用Go编写的。按照您平台的说明安装Go。

要手动运行服务器,请使用:```bash
export NETBIRD_API_TOKEN=your-token && \
go run cmd/mcp-netbird/main.go


或者在SSE模式下:```bash
export NETBIRD_API_TOKEN=your-token && \
go run cmd/mcp-netbird/main.go --transport sse --sse-address :8001

调试

这 MCP检查员 是一个用于测试和调试MCP服务器的交互式开发工具。阅读更多 这里.

以下是如何启动MCP检查器:```bash
export NETBIRD_API_TOKEN=your-token && \
npx @modelcontextprotocol/inspector


然后,Netbird MCP服务器可以通过以下任一方式进行测试 `stdio` 或 `SSE` 运输类型。对于 `stdio` 指定完整路径 `mcp-netbird` 在UI中。

### 测试

**TODO:添加更多测试**

### 代码检查

要提取代码,请运行:```bash
make lint

许可证

该项目根据 Apache许可证,版本2.0.

该项目包括Grafana Labs开发的软件(https://grafana.com/).

该项目包括Mark III实验室开发的软件(https://github.com/mark3labs/mcp-go).

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Netbird MCP Server 怎么安装?

在客户端按下面的安装命令接入:npx -y @smithery/cli install @aantti/mcp-netbird --client claude。对应的包名是 @smithery/cli。装完在客户端配置里引用同一个包或端点。

Netbird MCP Server 怎么在 Claude Desktop、Claude、Windsurf 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Netbird MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Netbird MCP Server 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Netbird MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Windsurf;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Netbird MCP Server 能提供哪些能力?

资料显示能力标签包括 网络管理、API集成、Go、Claude。具体工具清单以官方文档为准。

Netbird MCP Server 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Netbird MCP Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。