Apstra Mcp Server

Apstra MCP 服务

一个模型上下文协议（MCP）服务，提供用于与 Juniper Apstra Fabric Manager API 交互的工具。通过自然语言命令，让 Claude 和其他 MCP 客户端能够管理数据中心网络基础设施。

功能

• 蓝图管理：创建、获取和删除蓝图配置
• 基础设施查询：获取机架、路由区域和系统信息
• 网络配置：创建虚拟网络，并设置高级配置选项和远程网关
• 连接模板：管理连接模板和应用端点分配
• 策略管理：为应用端点应用和移除连接模板策略
• 配置管理：检查部署状态并部署配置
• 协议监控：监控 BGP 和其他协议会话
• 异常检测：获取并分析蓝图异常
• 原生流式传输支持：通过服务器发送事件实时更新

快速开始

本地使用（stdio）

# Create config file
cp apstra_config_sample.json apstra_config.json
# Edit with your Apstra server details

# Run with stdio transport
python3 apstra_mcp.py -t stdio -f apstra_config.json

网络部署（Streamable HTTP）

Docker（推荐）

# Clone and configure
git clone <this-repo>
cd apstra-mcp-server
cp apstra_config_sample.json apstra_config.json
# Edit config with your Apstra details

# Start HTTP streaming server
docker-compose up -d

直接使用 Python

# Install dependencies
pip install -r requirements.txt

# Start streamable HTTP server
python3 apstra_mcp.py -t streamable-http -H 0.0.0.0 -p 8080 -f apstra_config.json

安装

先决条件

• Python 3.7+
• 可访问 Juniper Apstra 服务
• 有效的 Apstra 凭据

依赖项

pip install -r requirements.txt

可用工具（共 21 个）

健康与状态工具（2 个）

• health() - 检查服务健康状况和 Apstra 连接状态
• formatting_guidelines() - 获取网络数据展示格式指南

查询工具（12 个）

• get_bp() - 获取蓝图信息
• get_racks(blueprint_id) - 获取机架信息
• get_rz(blueprint_id) - 获取路由区域
• get_vn(blueprint_id) - 获取虚拟网络
• get_ct(blueprint_id) - 获取连接模板
• get_app_ep(blueprint_id) - 获取连接模板对应的应用端点
• get_system_info(blueprint_id) - 获取系统／设备信息
• get_protocol_sessions(blueprint_id) - 获取协议会话
• get_anomalies(blueprint_id) - 获取蓝图异常
• get_remote_gw(blueprint_id) - 获取远程网关
• get_diff_status(blueprint_id) - 获取部署差异状态
• get_templates() - 获取可用模板

管理工具（3 个）

• deploy(blueprint_id, description, staging_version) - 部署配置
• delete_blueprint(blueprint_id) - 删除蓝图
• apply_ct_policies(blueprint_id, application_points) - 为应用端点应用／移除连接模板策略

创建工具（4 个）

• create_vn(blueprint_id, security_zone_id, vn_name, virtual_gateway_ipv4, ipv4_subnet, ...) - 创建虚拟网络，并设置高级配置选项
• create_remote_gw(blueprint_id, gw_ip, gw_asn, gw_name, local_gw_nodes, ...) - 创建远程网关
• create_datacenter_blueprint(blueprint_name, template_id) - 创建数据中心蓝图
• create_freeform_blueprint(blueprint_name) - 创建自由格式蓝图

安全模型

stdio 传输（默认）

• 默认安全，不暴露网络
• 使用配置文件中的凭据
• 适合与 Claude Desktop 集成

streamable-http 传输

• 可通过网络访问，并具备 FastMCP 原生流式传输功能
• 自动升级为 SSE，以支持实时更新
• 单容器部署

Claude Desktop 配置

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "apstra": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp,httpx",
        "python3",
        "/path/to/apstra_mcp.py",
        "-f",
        "/path/to/apstra_config.json"
      ]
    }
  }
}

将路径更新为与你的安装目录相匹配的路径。

使用示例

使用 Claude Desktop

• “显示系统中的所有蓝图”
• “创建一个名为‘web-tier’的虚拟网络，网关为 192.168.1.1，子网为 192.168.1.0/24”
• “获取蓝图 X 中的所有连接模板”
• “将连接模板策略 Y 应用到接口 Z”
• “显示连接模板对应的应用端点”
• “部署暂存配置”
• “检查蓝图 X 中是否存在异常”

流式 HTTP 客户端

服务器在 /mcp/* 上提供原生 FastMCP 端点，并会自动将流式响应升级为 SSE。

架构

• FastMCP 框架：原生传输系统，支持自动 SSE 流式传输
• 基于配置的身份验证：直接使用 Apstra API 身份验证，实现简单的无状态运行
• 单个容器：在端口 8080 上运行 HTTP 服务器，使用 streamable-http 传输

文档

• DEPLOYMENT.md - 完整的部署指南和示例
• CLAUDE.md - 技术实现详情和开发指南

故障排除

• 身份验证失败：检查凭据和服务器连接
• 未显示工具：在 Claude Desktop 日志中确认服务器已启动
• 传输错误：确保 FastMCP 版本兼容
• Docker 问题：检查 docker-compose logs

许可证

本项目按原样提供，仅用于教育和演示。

---

博客文章：数据中心网络的 MCP