Netwhisper Remote MCP Server

Netwhisper 远程 MCP 服务

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

概述

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

功能

• MCP 工具：包含 get_facts、get_config 和 add_static_route 等工具，可用于与网络设备交互。
• OAuth 身份验证：通过 OAuth 安全访问服务。
• Cloudflare Workers：部署在 Cloudflare Workers 上，具有可扩展性和高性能。
• KV 存储：使用 Cloudflare KV 存储与 OAuth 相关的数据。
• Durable Objects：通过 Durable Objects 实现有状态交互。

本地开发

要在本地开发和测试服务：

1. 克隆仓库：

   git clone [email protected]:pmesgari/netwhisper-mcp-server.git
   cd netwhisper-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 在本地运行服务：

   npm start
   

4. 在浏览器中打开服务： http://localhost:8787/

使用 MCP Inspector

要探索 MCP API，请使用 MCP Inspector：

1. 启动 Inspector：

   npx @modelcontextprotocol/inspector
   

2. 配置 Inspector：

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

3. 使用任意电子邮件地址和密码登录以访问工具。

连接到 Claude Desktop

要将服务连接到 Claude Desktop：

1. 更新 Claude 配置文件：

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

2. 重启 Claude Desktop，并确认工具可用。

部署到 Cloudflare

要将服务部署到 Cloudflare Workers：

1. 创建 KV 命名空间：

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

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

3. 部署服务：

   npm run deploy
   

4. 通过你的 workers.dev URL 访问已部署的服务。

调试

• 如果出现问题，请重启 Claude 或清除 ~/.mcp-auth 目录：

  rm -rf ~/.mcp-auth
  

• 使用 MCP Inspector 测试服务：

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

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。