MCP Server Scrapli

🚀 MCP 服務器 Scrapli

這是一個基本的 MCP（模型上下文協議）服務器，用於藉助 Scrapli 與網絡設備進行交互，能有效解決網絡設備連接與交互的問題，為相關操作提供便利。

🚀 快速開始

該項目是一個概念驗證，旨在展示兼容的 MCP 客戶端（如 Claude Desktop）如何通過 SSH 連接到網絡設備。Scrapli 被選為連接框架，因為它具有異步功能。

📦 安裝指南

⚠️ 重要提示

Scrapli 與 Windows 操作系統不兼容，因此此 MCP 服務器只能在 Linux/MacOS 上安裝。以下指南專用於 Linux 系統。

該項目使用 UV 進行包管理，你可以通過以下兩種方式進行安裝：

• 通過 pip 安裝：

pip install uv

• 使用 cURL 下載安裝腳本：

curl -LsSf https://astral.sh/uv/install.sh | sh

在 UV 安裝完成後，克隆此倉庫並使用 uv sync 安裝依賴項：

git clone https://git.mikelmaeso.com/mmaeso/mcp-server-scrapli.git
cd mcp-server-scrapli
uv sync

🔧 啟動服務器

1. 激活虛擬環境：

source .venv/bin/activate

2. 重命名 .env.example 文件為 .env，並設置你的設備用戶名和密碼。
3. 使用以下命令啟動服務器：

uv run main.py

默認情況下，服務器將在 0.0.0.0 和端口 8080 上監聽，但你可以通過 --host 和 --port 標誌更改此行為：

uv run main.py --host 127.0.0.1 --port 8081

🔧 與 Claude Desktop 使用

截至 2025 年 4 月，Claude Desktop 只能使用基於 stdio 的 MCP 服務器。如果你在 Windows 上使用 Claude Desktop，連接到此 MCP 服務器的唯一方法是使用 MCP SSE 門路（如 mcp-server-and-gw）。按照安裝說明操作，並在你的 claude_desktop_config.json 文件中添加以下配置：

{
  "mcpServers": {
    "Claude Gateway Example": {
      "command": "npx",
      "args": [
        "mcp-server-and-gw", "http://<hostname-of-mcp-server>:<port>/"
      ]
    }
  }
}