VI+ MCP Server

VI+ MCP Server 是一个基于Python的应用程序，设计用于通过Cisco CVM API获取并格式化关于常见漏洞和暴露（CVE）的详细信息。它提供了一个结构化且易于阅读的CVE数据摘要，包括风险评分、可利用性和修复方法。

在VS Code中配置为MCP服务器

要在VS Code中将VI+ MCP Server配置为MCP服务器，请按照以下步骤操作：

1. 打开你的VS Code设置文件（settings.json）。

2. 在"mcp"键下添加以下配置：

   "mcp": {
       "servers": {
           "VI+Bot": {
               "type": "stdio",
               "command": "python",
               "args": [
                   "/Github/VI-MCP/vi_mcp.py"
               ]
           }
       }
   }
   

3. 保存settings.json文件。

注意事项

• 确保已安装Python并且可以从终端访问。
• 项目根目录中必须存在.env文件，并包含所需的环境变量。
• 更新配置中的路径/Github/VI-MCP/vi_mcp.py到本地系统上的正确路径。
• 如果遇到问题，请验证vi_mcp.py的路径是否正确以及该文件是否可执行。

有关在VS Code中配置MCP服务器的更多信息，请参阅VS Code MCP服务器文档。

使用MCPO为Open-WebUI服务

Open-WebUI是一个强大的平台，允许您通过标准的OpenAPI端点集成和公开基于MCP的工具。通过使用MCP到OpenAPI代理（mcpo），您可以使您的MCP服务器通过REST API访问，从而实现与其他工具、服务和工作流程的无缝集成。Open-WebUI简化了部署过程，提供了自动生成的OpenAPI文档，并支持对您的API进行交互式探索。

要详细了解如何开始使用Open-WebUI，请参阅开始使用Open-WebUI部分。

为什么使用Open-WebUI与MCPO？

• 标准化API访问：将您的MCP服务器作为RESTful API公开，使其更容易与现有系统集成。
• 交互式文档：自动生成可通过内置Swagger UI访问的OpenAPI文档。
• 可扩展性和安全性：利用基于HTTP的通信，具有强大的身份验证和可扩展性功能。
• 易用性：通过最少的配置简化部署过程，无需定制客户端。

要使用MCP到OpenAPI代理（mcpo）将VI+ MCP Server服务于Open-WebUI，请遵循以下步骤：

1. 克隆仓库：

   git clone <repository-url>
   cd VI-MCP
   

2. 构建Docker镜像：

   docker build -t vi_mcp_server .
   

3. 使用Docker容器运行MCP到OpenAPI代理：

   uvx mcpo --port 8000 -- docker run -i --rm --env-file .env vi_mcp_server
   

4. 访问自动生成的OpenAPI文档：

   http://localhost:8000/docs
   

有关使用MCPO与Open-WebUI的更多细节，请参阅Open-WebUI MCP文档。
了解有关MCPO项目的更多信息，请访问其GitHub仓库。

推荐的Open-WebUI模型

我们建议在Open-WebUI中使用Gemma 3:12B模型与MCP一起。此模型是一款具有128K上下文窗口的高性能多模态模型，非常适合问答、总结和推理任务。它支持超过140种语言，并针对资源受限设备的部署进行了优化。

Gemma 3:12B模型的关键特性：

• 多模态能力：处理文本和图像。
• 大上下文窗口：128K令牌以处理大量输入。
• 高性能：在推理、逻辑和总结任务中表现出色。
• 紧凑设计：在单个GPU上高效运行。

有关更多信息，请访问Gemma 3:12B模型页面。

Open-WebUI的系统提示

推荐的系统提示可在SystemPrompt.md文件中找到。此提示提供了详细的指导，用于配置助手以优先考虑Cisco风险评分并提供可操作的漏洞见解。

环境变量

在项目根目录创建一个.env文件，内容如下：

RISK_TOKEN=your_api_token_here

测试

要使用test_vi_mcp.py脚本测试API，请执行以下操作：

1. 确保.env文件已配置好您的RISK_TOKEN。

2. 运行脚本：

   python3 test_vi_mcp.py
   

3. 脚本将获取并显示硬编码的CVE ID（CVE-2023-35078）的详细信息。

许可证

本项目采用MIT许可证。详情请参阅LICENSE文件。

贡献

欢迎贡献！请提交拉取请求或打开问题提出任何建议或改进。