aide-mcp-server

NetApp AI Data Engine（AIDE）MCP サーバー

説明

netapp-aide-mcp は、NetApp AI Data Engine の RAG（検索拡張生成）検索機能を MCP 経由で公開する MCP サーバー（Python パッケージ）です。このサーバーは、AIDE の RAG API を使用してドキュメントを検索する機能を提供する netapp_data_engine_search という名前のツールを公開します。この RAG API は、指定されたクエリに基づいて関連するドキュメントを取得する、ベクトルベースのセマンティック類似性検索エンジンを実装しています。

メモ

この MCP サーバーは stdio トランスポートを使用するため、「ローカル MCP サーバー」です。

クイックスタート

前提条件

• Python >= 3.10
• uv（すべてのインストールを自動的に管理します）

設定

サーバーを実行する前に、必要な設定を記述した .netapp ファイルをホームディレクトリに作成する必要があります。

1. .netapp ファイルを作成する：

   • ターミナルまたはファイルエクスプローラーを開きます。
   • ホームディレクトリ（Unix 系システムでは ~、Windows では C:\Users\YourUsername など）に移動します。
   • .netapp という名前の新しいファイルを作成します。

2. JSON 設定を追加する：

   • テキストエディターで .netapp ファイルを開きます。
   • 次の JSON 設定を追加し、サンプル値を独自の値に置き換えます。

   PKCE フローの場合：（マシンでブラウザーを使用できる場合に推奨）

   {
     "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
     }
   }
   

   デバイスコードフローの場合：（マシンでブラウザーを使用できない場合はこちらを使用してください。短いコードがログに出力されるので、コピーして、任意のデバイスで指定された確認 URL を開き、コードを入力して認証を完了します。）

   {
     "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"
     }
   }
   

   サポートされているのは PKCE（ウェブベース）フローとデバイスコードフローのみです。

3. ファイルのアクセス権を設定する：

   • セキュリティ上の理由から、他のユーザーやグループが .netapp ファイルを読み取れないようにしてください。

   • Unix 系システムでは、次のコマンドを使用してアクセス権を設定できます。

     chmod 600 ~/.netapp
     

   • Windows では、ファイルのプロパティダイアログからアクセス権を設定できます。

ヒント

リポジトリの Examples フォルダーには、.netapp.example ファイルが含まれています。このファイルには、.netapp ファイルの記述例が示されています。独自の .netapp ファイルを作成する際の参考として使用できます。

uvx で実行する

グローバルにインストールせずに、MCP サーバーをすぐに実行できます。

メモ

認証はサーバーの起動時ではなく、最初のツール呼び出し時に開始されます。最初のツール呼び出しが開始されると、PKCE フローを使用している場合はブラウザーウィンドウが開き、デバイスコードフローを使用している場合はデバイスコードの詳細が MCP サーバーのコンソールログに出力されます。

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 スクリプトで MCP サーバーを起動します

ソースからビルドして実行する

# Clone the repo
git clone https://github.com/NetApp/aide-mcp-server
cd aide-mcp-server

# Optional: check out a specific release
# git checkout tags/release-v1.0.0

# Retrieve the directory path for the cloned repo
export AIDE_MCP_REPO_PATH=$(pwd)

uvx --from $AIDE_MCP_REPO_PATH server

• server スクリプトで MCP サーバーを起動します

JSON 設定の例

この MCP サーバーを MCP クライアントで使用するには、このサーバーを使用するようにクライアントを設定する必要があります。VS Code、Claude Desktop、LMStudio など、多くのクライアントでは、JSON 形式の設定ファイル（多くの場合、mcp.json という名前）を編集する必要があります。以下に例を示します。具体的な書式については、お使いの MCP クライアントのドキュメントを参照してください。

メモ

ほとんどの MCP クライアントは MCP サーバーの起動を処理します。通常、自分でサーバーを起動する必要はありません。いつものように、MCP サーバーの処理方法については、お使いの MCP クライアントのドキュメントを参照することをおすすめします。

{
	"servers": {
		"netapp-aide-mcp": {
			"type": "stdio",
			"command": "uvx",
			"args": [
				"--from",
				"netapp-aide-mcp",
				"server"
			]
		}
	}
}

トラブルシューティング

• .netapp ファイルが存在し、正しい形式であることを確認してください。
• Python 3.10+ と uv がインストールされていることを確認してください。
• MCP クライアントが stdio トランスポートに対応していることを確認してください。ほとんどのデスクトップクライアント（例：VS Code、Claude Desktop、LMStudio）は対応していますが、一部のホスト型クライアントは対応していません。
• デバイスコード認証フローを使用している場合は、MCP サーバーのコンソールログでデバイスコードの詳細を確認してください。最初のツール呼び出しが開始されると、デバイスコードの詳細がログに出力されます。
• クライアントが MCP ツールを呼び出さない場合は、プロンプトに「Be sure to use NetApp AIDE」を追加してみてください。

MCP Registry のメタデータ

mcp-name: io.github.NetApp/aide-mcp-server

ライセンス

BSD 3-Clause License の条件に基づいて配布されます（リポジトリ内の LICENSE ファイルを参照してください）。