数据中心监控协议服务器

一个非官方的Equinix SmartView MCP服务器实现,用于将数据中心基础设施管理(DCIM)API与Claude Desktop集成,提供实时监控和AI辅助工作流。

  • by sliuuu
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 sliuuu/equinix-smartview-mcp

使用说明

非官方Equinix SmartView MCP服务器

一个非官方的模型上下文协议(MCP)服务器实现,用于将Equinix SmartView(数据中心基础设施管理(DCIM)API)与Claude桌面集成。 该项目使Claude能够通过经过身份验证的API调用,从SmartView查询实时数据(如电量、温度和环境遥测数据),为AI辅助工作流程提供实时操作上下文。

🚀 功能特性

  • OAuth 2.0 认证 - 采用自动令牌刷新的安全客户端凭据流程
  • 23 MCP 工具 - 全面覆盖SmartView API端点
  • 实时监控 - 环境、权限、资产和警报
  • 订阅管理 - 接近实时的事件流
  • 准备就绪,可投入生产 - 全面的错误处理和文档记录

📦 包含内容

环境监测(4种工具)

  • 当前温度和湿度数据
  • 历史趋势数据
  • 传感器列表及详情

电源管理(2种工具)

  • 当前功耗
  • 历史电力趋势

订阅管理(6种工具)

  • 创建/更新/删除订阅
  • 实时流数据访问

资产管理(4种工具)

  • 列出基础设施资产
  • 使用通配符搜索
  • 获取受影响的客户资产

层次导航(2种工具)

  • 位置层次结构
  • 权力等级制度

系统警报(2种工具)

  • 获取系统警报
  • 高级搜索功能

另外3个附加工具 用于标签点和资产管理

🔧 快速入门

先决条件

  • Python 3.10 或更高版本
  • Equinix客户门户账户
  • SmartView API访问已启用

安装

# Clone the repository
git clone https://github.com/sliuuu/equinix-smartview-mcp.git
cd equinix-smartview-mcp

# Run installation script
./scripts/install.sh

# Or manually:
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt

OAuth 2.0 设置

  1. 获取OAuth凭据

    • 登录到 Equinix 客户门户
    • 导航至:开发者设置 → 应用程序
    • 点击“创建新应用”
    • 复制客户端ID和客户端密钥
  2. 配置环境

    cp .env.example .env
    # Edit .env and add your credentials
    
  3. 配置Claude桌面版

    添加到您的Claude桌面配置中(~/Library/Application Support/Claude/claude_desktop_config.json):

    {
      \"mcpServers\": {
        \"equinix-smartview\": {
          \"command\": \"/path/to/venv/bin/python\",
          \"args\": [\"-m\", \"equinix_smartview_mcp.server\"],
          \"env\": {
            \"EQUINIX_CLIENT_ID\": \"your-client-id\",
            \"EQUINIX_CLIENT_SECRET\": \"your-client-secret\"
          }
        }
      }
    }
    
  4. 重启Claude桌面版

💡 使用示例

环境监测

What's the current temperature in my SV1 cage?

创建订阅

Create a subscription to monitor power alerts in SV1 and NY5

资产调查

Which circuits are affected by electrical asset EL-12345 in SV1?

📚 文档

🔐 安全

  • 符合OAuth 2.0标准
  • 自动令牌刷新(有效期1小时)
  • 安全凭证管理
  • 没有硬编码的秘密

🤝 贡献

欢迎投稿!请阅读我们的 贡献指南 首先。

📝 许可证

MIT 许可证 - 详见 许可证 文件中详述

🔗 链接

💬 支持

  • 问题: GitHub Issues(GitHub问题)
  • 文档https://docs.equinix.com 翻译为中文是:“https://equinix文档中心”。不过,通常我们不会直接翻译网址,而是会说明其内容或用途,比如“Equinix的官方文档网站”。但在这里,按照您的要求,直接翻译网址部分即为“https://equinix文档中心”

版本2.0.0

状态实验性的