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