Suzieq MCP

🚀 MCP サーバー構成ガイド（SuzieQ）

MCP（Multi-Cloud Platform）サーバーは、マルチクラウド環境を管理するためのツールです。一方、SuzieQ は、ネットワーク機器の状態を監視および分析するためのオープンソースツールです。このドキュメントでは、MCP サーバーに SuzieQ 機能を統合するための構成方法を説明します。

🚀 クイックスタート

📦 インストール

依存関係のインストール

1. Python 環境：
   • Python 3.6 以上がインストールされていることを確認してください。
2. pip パッケージマネージャー：
   • 以下のコマンドを使用して pip をインストールします。

     get-pip.py
     

3. 必要なパッケージのインストール：
   • requests と json パッケージをインストールします。

     pip install requests json
     

SuzieQ サーバーの構成

1. SuzieQ のダウンロード：
   • SuzieQ 公式サイト から最新バージョンの SuzieQ をダウンロードします。
2. SuzieQ のインストール：
   • ダウンロードしたファイルを解凍し、README ファイルの説明に従ってインストールします。

MCP サーバーの構成

1. プロジェクトディレクトリの作成：
   • システム内に、MCP サーバーの関連ファイル（main.py や .env など）を保存するための新しいディレクトリを作成します。
2. メインスクリプト (main.py) の作成：
   • Python スクリプトファイル main.py を作成し、以下の内容を記述します。

     import os
     import json
     import requests
     
     # 環境変数から SuzieQ の API エンドポイントとキーを取得
     endpoint = os.getenv('SUZIEQ_API_ENDPOINT')
     api_key = os.getenv('SUZIEQ_API_KEY')
     
     def run_suzieq_show(table, filters=None):
         data = {"table": table}
         if filters:
             data["filters"] = filters
         try:
             response = requests.post(
                 f"{endpoint}/api/v1/show",
                 headers={"Authorization": f"Bearer {api_key}"},
                 json=data
             )
             response.raise_for_status()
             return json.dumps(response.json())
         except requests.exceptions.RequestException as e:
             return f"Error: {str(e)}"
     
     def run_suzieq_summarize(table, filters=None):
         data = {"table": table}
         if filters:
             data["filters"] = filters
         try:
             response = requests.post(
                 f"{endpoint}/api/v1/summarize",
                 headers={"Authorization": f"Bearer {api_key}"},
                 json=data
             )
             response.raise_for_status()
             return json.dumps(response.json())
         except requests.exceptions.RequestException as e:
             return f"Error: {str(e)}"
     
     if __name__ == "__main__":
         # サンプル呼び出し
         print(run_suzieq_show("device"))
         print(run_suzieq_summarize("bgp", {"hostname": "spine01"}))
     

3. 環境変数ファイル (env) の作成：
   • （原文に具体的な作成方法がないため、このまま記載）環境変数ファイルを作成し、必要な情報を設定します。