NetApp AI Data Engine (AIDE) MCP Server

Description

netapp-aide-mcp is an MCP server (Python package) that exposes the NetApp AI Data Engine's RAG (Retrieval-Augmented Generation) search functionality via MCP. The server exposes a tool named netapp_data_engine_search, which provides the ability to search for documents using AIDE's RAG API. This RAG API implements a vector-based semantic similarity search engine that retrieves relevant documents based on the provided query.

[!NOTE] This MCP server uses the stdio transport, making it a "local MCP server".

Quick start

Prerequisites

• Python >= 3.10
• uv (manages all installations automatically)

Configuration

Before running the server, you need to create a .netapp file in your home directory with the necessary configuration.

1. Create the .netapp file:

   • Open a terminal or file explorer.
   • Navigate to your home directory (e.g., ~ on Unix-like systems or C:\Users\YourUsername on Windows).
   • Create a new file named .netapp.

2. Add the JSON configuration:

   • Open the .netapp file in a text editor.
   • Add the following JSON configuration, replacing the example values with your own:

   For PKCE flow: (Recommended if you have a browser available on your machine)

   {
     "rag_search_api_endpoint_url": "https://example.com/api",
     "verify_ssl": true,
     "auth_flow": "pkce",
     "token_request_endpoint_url": "https://login.microsoftonline.com/<tenant>/oauth2/v2.0/authorize",
     "token_exchange_endpoint_url": "https://login.microsoftonline.com/<tenant>/oauth2/v2.0/token",
     "token_request_params": {
       "client_id": "your_client_id",
       "redirect_uri": "http://localhost:8888",
       "scope": "api://your-app/.default",
       "use_pkce": true,
       "auth_timeout_seconds": 300
     }
   }
   

   For device code flow: (Use this if you do not have a browser on your machine. A short code will be printed in the logs — copy it, open the provided verification URL on any device, and enter the code to complete authentication.)

   {
     "rag_search_api_endpoint_url": "https://example.com/api",
     "verify_ssl": true,
     "auth_flow": "device_code",
     "device_code_endpoint_url": "https://login.microsoftonline.com/<tenant>/oauth2/v2.0/devicecode",
     "token_request_endpoint_url": "https://login.microsoftonline.com/<tenant>/oauth2/v2.0/token",
     "token_request_params": {
       "client_id": "your_client_id",
       "scope": "api://your-app/.default"
     }
   }
   

   Only PKCE (web-based) and Device Code flows are supported.

3. Set file permissions:

   • Ensure that the .netapp file is not readable by other users/groups for security reasons.

   • On Unix-like systems, you can set the permissions using the following command:

     chmod 600 ~/.netapp
     

   • On Windows, you can set the file permissions through the file properties dialog.

[!TIP] There is an Examples folder in the repository that contains a .netapp.example file. This file provides examples of how your .netapp file should look. You can use this as a reference when creating your own .netapp file.

Running with uvx

You can run the MCP server instantly, without installing anything globally.

[!NOTE] Authentication is initiated on the first tool call, not at server startup. When the first tool call is initiated: if you are using the PKCE flow, a browser window will open; if you are using the device code flow, the device code details will be printed to the MCP server's console logs.

Run pre-built package from PyPI

# Run the latest stable version
uvx --from netapp-aide-mcp server

# Run a specific version
uvx --from netapp-aide-mcp==1.0.0 server

• server script launches the MCP server

Build and

... View full README on GitHub