VI+ MCP Server

VI+ MCP Server

VI+ MCP Server 是一款基于 Python 的应用程序，旨在使用 Cisco CVM API 获取并整理常见漏洞和暴露（CVE）的详细信息。它会提供结构清晰、易于阅读的 CVE 数据摘要，包括风险评分、可利用性和修复方案。

在 VS Code 中作为 MCP Server 提供服务

要在 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 Server 文档。

使用 MCPO 为 Open-WebUI 提供服务

Open-WebUI 是一个功能强大的平台，可让你通过标准 OpenAPI 端点集成并公开基于 MCP 的工具。借助 MCP-to-OpenAPI 代理（mcpo），你可以通过 REST API 访问 MCP 服务，从而与其他工具、服务和工作流无缝集成。Open-WebUI 简化了部署，提供自动生成的 OpenAPI 文档，并支持交互式探索 API。

有关 Open-WebUI 入门的详细指南，请参阅Open-WebUI 入门部分。

为什么将 Open-WebUI 与 MCPO 搭配使用？

• 标准化 API 访问：将 MCP 服务公开为 RESTful API，便于与现有系统集成。
• 交互式文档：自动生成 OpenAPI 文档，并通过内置的 Swagger UI 访问。
• 可扩展性和安全性：利用基于 HTTP 的通信方式，以及可靠的身份验证和可扩展性功能。
• 易于使用：只需进行少量配置，无需自定义客户端即可简化部署流程。

要通过 MCP-to-OpenAPI 代理（mcpo）为 Open-WebUI 提供 VI+ MCP Server 服务，请按以下步骤操作：

1. 克隆代码库：

   git clone <repository-url>
   cd VI-MCP
   

2. 构建 Docker 镜像：

   docker build -t vi_mcp_server .
   

3. 使用 Docker 容器运行 MCP-to-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 文档。
在其 GitHub 代码库中了解更多 MCPO 项目信息。

Open-WebUI 推荐模型

我们建议在 Open-WebUI 中将 Gemma 3:12B 模型与 MCP 搭配使用。该模型是一款能力出色的多模态模型，拥有 128K 上下文窗口，非常适合问答、摘要和推理等任务。它支持 140 多种语言，并针对在资源受限的设备上部署进行了优化。

Gemma 3:12B 模型的主要特性：

• 多模态能力：可处理文本和图像。
• 大上下文窗口：128K 个令牌，可处理大量输入。
• 高性能：擅长推理、逻辑和摘要任务。
• 紧凑设计：可在单个 GPU 上高效运行。

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

Open-WebUI 的系统提示词

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 文件。

参与贡献

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