Meraki MCP Server DONOTTRUST

I no longer work for Cisco so will not be updating this repo.

This Model Context Protocol (MCP) server enables interaction with the Meraki Dashboard API for LLMs, allowing for seamless integration of Meraki network management capabilities within an AI assistant's conversational interface.

Warning

Do not use if your organization prohibits you or you do not feel comfortable sending data to an AI assistant. This tool will send sensitive information such as serial numbers, hostnames, MAC addresses, and other information obtained through Meraki Dashboard APIs.

Environment

• node v23.7.0

• npm v10.9.2

• Meraki Dashboard API key

• Claude Desktop App

Building the MCP

1. Clone this repository:

git clone git@github.com:yujiterada/mcp-server-meraki-donottrust.git
cd mcp-server-meraki-donottrust

2. Install dependencies:

npm install

3. Set up environment variables:

cp .env.sample .env

4. Edit the .env file:

   • Set your MERAKI_DASHBOARD_API_KEY from your Meraki Dashboard

   • Configure API endpoint scopes by setting the following variables to true or false:

     • ADMINISTERED_API_ENABLED

     • APPLIANCE_API_ENABLED

     • CAMERA_API_ENABLED

     • CAMPUS_GATEWAY_API_ENABLED

     • CELLULAR_GATEWAY_API_ENABLED

     • DEVICES_API_ENABLED

     • INSIGHT_API_ENABLED

     • LICENSING_API_ENABLED

     • NETWORKS_API_ENABLED

     • ORGANIZATIONS_API_ENABLED

     • SECURE_CONNECT_API_ENABLED

     • SENSOR_API_ENABLED

     • SM_API_ENABLED

     • SWITCH_API_ENABLED

     • WIRELESS_API_ENABLED

     • WIRELESS_CONTROLLER_API_ENABLED

   Note: It's recommended to enable only the API endpoint scopes you need, as enabling all scopes might exceed Claude's context limits. Chat length is vrey limited on free version of Claude and therefore, the user will need to enable/disable spefici API endpoints from Claude app.

5. Build the project:

npm run build

Adding MCP to Claude Desktop App

1. Open Claude Desktop App

2. Go to Settings

3. Navigate to the MCP section

4. Click "Developer" on the left hand side

5. Click "Edit Config"

6. Create/Edit a file entering the following details:

   macOS

   {
       "mcpServers": {
           "meraki": {
               "command": "node",
               "args": [
                   "--env-file=/path/to/mcp-server-meraki/.env",
                   "/path/to/mcp-server-meraki/build/index.js"
               ]
           }
       }
   }

   Windows

   {
       "mcpServers": {
           "meraki": {
               "command": "C:\\path\\to\\node.exe",
               "args": [
                   "--env-file=C:\\path\\to\\mcp-server-meraki-donottrust\\.env",
                   "C:\\path\\to\\mcp-server-meraki-donottrust\\build\\index.js"
               ]
           }
       }
   }

7. Restart app

Future Development

The following improvements are planned for future development:

1. TypeScript Integration

   • Add TypeScript interfaces for all API responses

   • Implement Zod schemas for runtime type validation

   • Improve type safety across the codebase

2. Dynamic API Scope

   • Explore implementing Meraki Dashboard API scopes as Tools

   • Allow users to select which APIs to use directly from Claude's interface

   • Eliminate the need for .env file modifications and rebuilds

3. Security Enhancements

   • Implement encryption for sensitive information

   • Add secure decoding mechanisms within the MCP

   • Enhance API key management and security

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License