LISA MCP Server

LISA MCP服务器

Microsoft LISA的模型上下文协议服务器——Linux集成服务自动化

将任何兼容MCP的AI（GitHub Copilot、VS Code或任何MCP客户端）直接连接到 微软LISA Linux测试框架。通过自然语言选择测试用例、生成测试代码、构建runbook配置、运行测试以及使用AI分析故障。

______________________________________________________________________

什么是LISA？

LISA（Linux集成服务自动化）是微软针对Azure、HyperV和裸机上的Linux的质量验证系统。它提供：

• A. 声明性测试框架 内置Python
• 数百 内置测试套件 涵盖网络、存储、CPU、内存、内核、管理程序集成等
• 多平台支持：Azure、HyperV、QEMU、裸机
• Runbook驱动的执行 通过YAML配置文件
• 基于层次的测试选择 （T0–T4）用于不同的CI/CD阶段

______________________________________________________________________

此MCP服务器添加了什么

______________________________________________________________________

LLM故障分析——多提供商AI支持

该服务器与任何兼容OpenAI的LLM集成，以提供AI驱动的故障分析：

• 根本原因分类 --对故障进行分类（磁盘I/O、网络超时、内核死机等）
• 可操作的修复建议 --要调查的特定命令、文件路径、设置
• 严重性评分 --关键/高/中/低优先级
• 运行级别执行摘要 --利益相关者准备的健康报告
• HTML+Markdown报告 --可共享分析工件

支持的提供商 --通过任何 endpoint 到分析工具：

使用 list_llm_providers 该工具可随时查看所有选项及其配置。

聊天中的示例用法：

Analyze the failures in ~/lisa/lisa_results.xml
API key: 
Endpoint: https://api.openai.com/v1/chat/completions
Model: gpt-4o
Save the report to ~/reports/

如果没有提供端点，服务器将使用预配置的Azure OpenAI默认值。

______________________________________________________________________

快速示例

You: "Scan my LISA repo and show me all network tests at tier T1,
      then build a runbook for Azure that runs them on Ubuntu 22.04"

The AI invokes:
  1. discover_test_cases(lisa_path="~/lisa", area="network", tier="T1")
  2. build_runbook(name="Network T1", platform_type="azure",
                   tier="T1", image="ubuntu jammy 22.04-lts latest")

Result: a filtered list of tests + a ready-to-use runbook.yml

______________________________________________________________________

入门指南

1--安装

git clone https://github.com/kkkashan/LISA_MCP_Server.git ~/lisa-mcp-server
cd ~/lisa-mcp-server
pip install -e .

2--使用VS代码注册

存储库附带了 .vscode/mcp.json 它在VS Code中自动注册服务器。打开工作区——VS Code将检测到它并主动启动服务器。

或者，手动将其添加到 .vscode/mcp.json:

{
  "servers": {
    "lisa": {
      "command": "python3",
      "args": ["-m", "lisa_mcp.server"],
      "cwd": "/absolute/path/to/lisa-mcp-server"
    }
  }
}

3--开始提问

打开GitHub Copilot Chat（或任何MCP客户端），从以下内容开始：

Check the LISA environment and show me the available test tiers

______________________________________________________________________

文档

______________________________________________________________________

18个MCP工具

______________________________________________________________________

项目结构

lisa-mcp-server/
├── README.md                         ← You are here
├── QUICKSTART.md                     ← Start here
├── INSTALL.md                        ← Installation guide
├── USAGE.md                          ← Usage guide
├── pyproject.toml                    ← Python package metadata
├── mcp_config.json                   ← MCP client config snippet
├── .vscode/
│   └── mcp.json                      ← VS Code MCP server registration
│
├── lisa_mcp/                         ← Python package
│   ├── server.py                     ← FastMCP server (18 tools, 3 resources, 3 prompts)
│   ├── models.py                     ← Pydantic data models
│   └── tools/
│       ├── test_discovery.py         ← AST-based test scanner
│       ├── test_generator.py         ← Code + YAML generation
│       ├── runbook_builder.py        ← Runbook build/validate/update
│       ├── test_runner.py            ← lisa CLI subprocess wrapper
│       ├── result_parser.py          ← JUnit XML + console output parser
│       ├── log_collector.py          ← Memory-safe log extraction
│       ├── llm_analyzer.py           ← Azure OpenAI failure analysis
│       └── report_generator.py       ← HTML + Markdown report generation
│
├── docs/
│   ├── running-lisa.md               ← Step-by-step run guide
│   ├── tools-reference.md            ← All 18 tools documented
│   ├── test-discovery.md             ← Discovery internals
│   ├── writing-tests.md              ← Test authoring guide
│   ├── runbook-guide.md              ← Runbook authoring guide
│   ├── llm-analysis.md               ← AI analysis pipeline
│   ├── automation-guide.md           ← CI/CD integration
│   └── troubleshooting.md            ← Problem solving
│
└── examples/
    ├── azure_t1_runbook.yml          ← Ready-to-use T1 runbook
    ├── custom_selection_runbook.yml  ← Custom test selection
    ├── new_test_suite_example.py     ← Example test suite
    └── network_connectivity_test.py  ← Generated network test suite

______________________________________________________________________

许可证

麻省理工学院——见 许可证.