Netwhisper MCP Server

Netwhisper远程MCP服务器

一个远程MCP服务器，用于促进与网络设备的交互。

概述

Netwhisper Remote MCP Server是基于Cloudflare Workers的模型上下文协议（MCP）服务器的实现。它提供了与网络设备交互、检索配置详细信息和远程管理设备设置的工具。该服务器支持基于OAuth的身份验证，并与MCP Inspector和Claude Desktop等工具无缝集成。

特性

• MCP工具：包括以下工具 get_facts, get_config，以及 add_static_route 以与网络设备交互。
• OAuth身份验证：使用OAuth安全访问服务器。
• Cloudflare员工：部署在Cloudflare Workers上以实现可扩展性和性能。
• KV存储：使用Cloudflare KV存储OAuth相关数据。
• 耐用物品：实现用于有状态交互的持久对象。

地方发展

要在本地开发和测试服务器，请执行以下操作：

1. 克隆存储库：

   git clone git@github.com:pmesgari/netwhisper-mcp-server.git
   cd netwhisper-mcp-server

1. 安装依赖项：

   npm install

1. 在本地运行服务器：

   npm start

1. 在浏览器中打开服务器：

http://localhost:8787/

使用MCP检查器

要探索MCP API，请使用 MCP检查员:

1. 启动检查器：

   npx @modelcontextprotocol/inspector

1. 配置检查器：

- 将传输类型设置为 SSE. - 进入 http://localhost:8787/sse 作为URL。 - 点击“连接”。

1. 使用任何电子邮件和密码登录以访问工具。

连接到克劳德桌面

要将服务器连接到Claude Desktop，请执行以下操作：

1. 更新Claude配置文件：

    {
      "mcpServers": {
        "netwhisper": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "http://localhost:8787/sse"
          ]
        }
      }
    }

1. 重新启动Claude Desktop并验证工具是否可用。

部署到Cloudflare

要将服务器部署到Cloudflare Workers，请执行以下操作：

1. 创建KV命名空间：

   npx wrangler@latest kv namespace create remote-mcp-server-oauth-kv

1. 将KV命名空间ID添加到 wrangler.jsonc.

1. 部署服务器：

   npm run deploy

1. 访问您所在位置的已部署服务器 workers.dev URL。

调试

• 重新启动Claude或清除 ~/.mcp-auth 目录（如果出现问题）：

  rm -rf ~/.mcp-auth

• 使用MCP检查器测试服务器：

  npx mcp-remote http://localhost:8787/sse

许可证

该项目根据MIT许可证获得许可。有关详细信息，请参阅LICENSE文件。