MCP Linstor

Linstor MCP 服务器

一个模型上下文协议（MCP）服务器用于 Linstor（通常指的是一种用于容器编排和存储管理的系统或工具，具体名称可能根据上下文有所不同，但直接翻译即为“林斯托尔”） 存储系统。该服务器提供MCP工具，可通过其REST API与Linstor集群进行交互，使AI助手和其他MCP客户端能够查询和管理Linstor存储资源。

特点/特性

• MCP标准合规性实现了MCP规范，使用 FastMCP
• 可流式传输的HTTP传输使用可流式传输的HTTP传输以实现高效通信
• 工具：

- pingLinstor API可用性的健康检查 - list_resources查询存储系统中的所有卷资源 - list_nodes查询 Linstor 集群中的所有节点

• 基于环境的配置通过环境变量进行配置

建筑学

该项目的设计兼顾了可维护性和可测试性：

mcp-linstor/
├── server.py              # Main MCP server with FastMCP
├── config.py              # Configuration management
├── linstor_client.py      # Linstor REST API client
├── requirements.txt       # Production dependencies
├── requirements-dev.txt   # Development dependencies
└── tests/                 # Comprehensive test suite
    ├── test_config.py
    ├── test_linstor_client.py
    └── test_server.py

安装

先决条件

• Python 3.10 或更高版本
• 访问启用了REST API的Linstor集群

设置

1. 克隆或导航到项目目录：

   cd /path/to/mcp-linstor

1. 创建并激活虚拟环境:

   python3 -m venv venv
   source venv/bin/activate  # On macOS/Linux
   # or
   venv\Scripts\activate  # On Windows

1. 安装依赖项：

   pip install -r requirements.txt

1. 用于开发（包括测试工具）：

   pip install -r requirements-dev.txt

配置

使用环境变量配置服务器：

示例配置

export LINSTOR_BASE_URL="http://linstor-controller.example.com:3370"
export LINSTOR_TIMEOUT="60"
export LINSTOR_DEBUG="true"

或者创建一个 .env 文件：

LINSTOR_BASE_URL=http://linstor-controller.example.com:3370
LINSTOR_TIMEOUT=60
LINSTOR_DEBUG=true
LINSTOR_USERNAME=admin
LINSTOR_PASSWORD=secret

用法

运行服务器

# Activate virtual environment
source venv/bin/activate

# Run the server
python server.py

服务器将在默认的MCP流式HTTP传输上启动，并准备好接受MCP客户端的连接。

MCP规范

此服务器实现了工具的模型上下文协议规范：

• 工具/列表列出可用工具（ping，list_resources，list_nodes）
• 工具/调用执行带有给定参数的工具
• 工具/结果返回工具执行结果

服务器使用：

• 交通可流式传输的HTTP（无状态，使用JSON响应）
• FastMCP从官方Python SDK简化实现的MCP服务器

参考文献

• 模型上下文协议规范
• MCP Python SDK
• FastMCP 文档
• Linstor 文档
• Linstor REST API