🚀 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>/"
      ]
    }
  }
}