Suzieq MCP

🚀 MCP 服務器配置指南（SuzieQ）

MCP（Multi - Cloud Platform）服務器是用於管理多雲環境的工具，而 SuzieQ 是用於監控和分析網絡設備狀態的開源工具。本文將詳細指導您如何配置 MCP 服務器，以集成 SuzieQ 功能。

🚀 快速開始

本指南將引導您完成 MCP 服務器集成 SuzieQ 功能的安裝與配置過程。

📦 安裝指南

安裝依賴

• Python 環境： 確保系統已安裝 Python 3.6 或更高版本。
• pip 包管理器： 使用以下命令安裝 pip：

  get - pip.py
  

• 安裝必要的包： 安裝 requests 和 json 包：

  pip install requests json
  

配置 SuzieQ 服務器

• 下載 SuzieQ： 從 SuzieQ 官方網站 下載最新版本的 SuzieQ。
• 安裝 SuzieQ： 解壓下載的文件，並按照 README 文件中的說明進行安裝。

配置 MCP 服務器

• 創建項目目錄： 在系統中創建一個新目錄，用於存放 MCP 服務器的相關文件（如 main.py 和 .env）。
• 編寫主腳本 (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"}))
  

💻 使用示例

基礎用法

以下是 main.py 腳本的基礎使用示例，用於調用 run_suzieq_show 和 run_suzieq_summarize 函數：

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