What is Netwhisper Mcp Server

Netwhisper Remote MCP Server is a Cloudflare Workers-based implementation of a Model Context Protocol (MCP) server that facilitates interactions with network devices, allowing remote management of device settings and retrieval of configuration details.

Use cases

Use cases include remote monitoring and management of network devices, automated configuration retrieval, and integration with other tools like MCP Inspector and Claude Desktop for enhanced network operations.

How to use

To use the netwhisper-mcp-server, clone the repository, install the dependencies, and run the server locally. Access the server via a web browser at http://localhost:8787/. Use the MCP Inspector to explore the API and connect to Claude Desktop by updating its configuration file.

Key features

Key features include MCP tools for device interaction (like get_facts and get_config), OAuth-based authentication for secure access, deployment on Cloudflare Workers for scalability, Cloudflare KV for storing OAuth data, and Durable Objects for stateful interactions.

Where to use

Netwhisper-mcp-server can be used in network management, IT infrastructure, and cloud-based applications where remote device interaction and configuration management are required.

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.