Netbird MCP 服务器集成

无缝连接您的 AI 代理至 Netbird，通过 MCP 实现安全、实时的网络洞察与配置监控。

AI MCP Networking Netbird

“Netbird” MCP 服务器的作用是什么？

Netbird MCP 服务器是为将 AI 助手与 Netbird 网络管理平台连接而设计的模型上下文协议（MCP）服务器。通过对接 Netbird API，该 MCP 服务器使 AI 模型和代理能够直接从 Netbird 获取网络配置、状态及相关信息。此集成提升了开发工作流，例如可通过标准协议查询网络资源、获取配置信息、监控网络状态等。服务器注重安全，采用令牌认证机制，并支持自定义 Netbird API 端点。请注意，当前实现仅为部分只读 Netbird API 资源的 1:1 映射，主要支持信息检索。

提示词列表

资源列表

工具列表

Netbird MCP 服务器暴露的 MCP 工具有部分只读 Netbird API 资源的映射。但具体工具名称及其描述，在现有文档和代码概览中未有详细说明。

该 MCP 服务器的应用场景

网络配置监控： 开发者可通过 MCP 服务器获取最新 Netbird 网络配置，并用于可视化或审计当前网络设置。
网络状态检查： 服务器可提供来自 Netbird API 的实时状态信息，便于主动进行网络健康检查。
安全 API 集成： 通过令牌认证，MCP 服务器为自动化任务提供安全、可编程的 Netbird 数据访问。
可定制 API 端点访问： 开发者可将服务器指向不同 Netbird API 主机，支持测试或预发布环境。

如何进行配置

Windsurf

确认已安装 Node.js 和 Windsurf 应用。
找到 Windsurf 配置文件（通常为 windsurf.json）。

在 mcpServers 部分添加 Netbird MCP 服务器：

{
  "mcpServers": {
    "netbird": {
      "command": "npx",
      "args": ["@aantti/mcp-netbird@latest"]
    }
  }
}

保存配置并重启 Windsurf。
通过检查 Windsurf 日志确认服务器连接成功。

Claude

安装 Node.js 和 Claude 桌面客户端。
打开配置文件（如 claude.json）。

添加 Netbird MCP 服务器配置：

{
  "mcpServers": {
    "netbird": {
      "command": "npx",
      "args": ["@aantti/mcp-netbird@latest"]
    }
  }
}

重启 Claude。
在 MCP 面板确认 Netbird MCP 服务器已激活。

Cursor

确保已安装 Node.js 和 Cursor。
编辑 Cursor 配置（如 .cursor.json）。

插入以下 MCP 服务器设置：

{
  "mcpServers": {
    "netbird": {
      "command": "npx",
      "args": ["@aantti/mcp-netbird@latest"]
    }
  }
}

保存更改并重启 Cursor。
在 Cursor 界面检查服务器连接情况。

Cline

安装 Node.js 和 Cline。
找到并打开配置文件（如 cline.json）。

添加 Netbird MCP 服务器条目：

{
  "mcpServers": {
    "netbird": {
      "command": "npx",
      "args": ["@aantti/mcp-netbird@latest"]
    }
  }
}

保存并重启 Cline。
确认 Netbird MCP 服务器已列为激活状态。

API 密钥安全存储

请将您的 Netbird API 密钥存储在环境变量中以保障安全：

{
  "mcpServers": {
    "netbird": {
      "command": "npx",
      "args": ["@aantti/mcp-netbird@latest"],
      "env": {
        "NETBIRD_API_TOKEN": "your_secret_token"
      },
      "inputs": {
        "NETBIRD_HOST": "api.netbird.io"
      }
    }
  }
}

如何在流程中使用此 MCP

在 FlowHunt 中使用 MCP

要将 MCP 服务器集成到您的 FlowHunt 工作流中，首先在流程中添加 MCP 组件，并将其连接到您的 AI 代理：

点击 MCP 组件以打开配置面板。在系统 MCP 配置部分，按如下 JSON 格式插入您的 MCP 服务器详情：

{
  "netbird": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI 代理即可作为工具使用此 MCP，并拥有其全部功能和能力。请记得将 “netbird” 替换为您实际的 MCP 服务器名称，并将 URL 替换为您自己的 MCP 服务器地址。

总览

部分	可用性	详情/备注
总览	✅
提示词列表	⛔	仓库或文档中未找到提示词模板
资源列表	⛔	未有明确的 MCP 资源文档
工具列表	✅	工具可用，但未详细列出/描述
API 密钥安全	✅	通过环境变量方式描述
采样支持（评估中不是重点）	⛔	未提及