mcpField
N
Netwhisper Remote MCP Server

Netwhisper Remote MCP Server

Local
github.com/pmesgariCloud & Infra1Updated 77w ago
Repository

About Netwhisper Remote MCP Server

Netwhisper Remote MCP Server is a Cloudflare Workers-based server for remotely inspecting and managing network devices. It provides device facts, configuration retrieval, and static-route management through OAuth-protected MCP tools.

Key features

  1. 01Retrieve device facts
  2. 02Read device configuration
  3. 03Add static routes
  4. 04OAuth authentication
  5. 05Cloudflare KV and Durable Objects

Use cases

  1. 01Inspect network device details remotely
  2. 02Retrieve device configurations
  3. 03Add static routes through an MCP client

MCP support

Exposes network-device tools to MCP clients, including `get_facts`, `get_config`, and `add_static_route`. The server supports OAuth and can connect to Claude Desktop.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "netwhisper": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
Run commandnpx -y @modelcontextprotocol/inspector

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@modelcontextprotocol/inspector

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Netwhisper Remote MCP Server

A remote MCP server to facilitate interactions with network devices.

Overview

Netwhisper Remote MCP Server is a Cloudflare Workers-based implementation of a Model Context Protocol (MCP) server. It provides tools to interact with network devices, retrieve configuration details, and manage device settings remotely. The server supports OAuth-based authentication and integrates seamlessly with tools like the MCP Inspector and Claude Desktop.

Features

  • MCP Tools: Includes tools like get_facts, get_config, and add_static_route to interact with network devices.
  • OAuth Authentication: Secure access to the server using OAuth.
  • Cloudflare Workers: Deployed on Cloudflare Workers for scalability and performance.
  • KV Storage: Uses Cloudflare KV for storing OAuth-related data.
  • Durable Objects: Implements Durable Objects for stateful interactions.

Local Development

To develop and test the server locally:

  1. Clone the repository:

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

  2. Install dependencies:

    npm install

  3. Run the server locally:

    npm start

  4. Open the server in your browser: http://localhost:8787/

Using the MCP Inspector

To explore the MCP API, use the MCP Inspector:

  1. Start the inspector:

    npx @modelcontextprotocol/inspector

  2. Configure the inspector:

    • Set the Transport Type to SSE.
    • Enter http://localhost:8787/sse as the URL.
    • Click "Connect".

  3. Log in using any email and password to access the tools.

Connecting to Claude Desktop

To connect the server to Claude Desktop:

  1. Update the Claude configuration file:

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

  2. Restart Claude Desktop and verify the tools are available.

Deployment to Cloudflare

To deploy the server to Cloudflare Workers:

  1. Create a KV namespace:

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

  2. Add the KV namespace ID to wrangler.jsonc.

  3. Deploy the server:

    npm run deploy

  4. Access the deployed server at your workers.dev URL.

Debugging

  • Restart Claude or clear the ~/.mcp-auth directory if issues arise:

    rm -rf ~/.mcp-auth

  • Test the server using the MCP Inspector:

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

License

This project is licensed under the MIT License. See the LICENSE file for details.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.