远程MCP服务器

Netwhisper Remote MCP Server是一个基于Cloudflare Workers的模型上下文协议(MCP)服务器,用于远程与网络设备交互、检索配置详情和管理设备设置。

  • by pmesgari
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 pmesgari/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
    
  2. 安装依赖项:

    npm install
    
  3. 在本地运行服务器:

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

使用MCP检查器

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

  1. 启动检查器:

    npx @modelcontextprotocol/inspector
    
  2. 配置检查器:

    • 将传输类型设置为 SSE.
    • 进入 http://localhost:8787/sse 作为URL。
    • 点击“连接”。
  3. 使用任何电子邮件和密码登录以访问工具。

连接到克劳德桌面

要将服务器连接到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检查器测试服务器:

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

许可证

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