Booner_MCP

一个使用模型上下文协议 (MCP) 的 AI 基础设施即代码平台，结合 Ollama 用于代理编码和服务器管理。

概述

该项目允许 AI 代理与本地基础设施交互，通过模型上下文协议部署和管理各种服务器类型（Web 服务器、游戏服务器、数据库）。它与本地 Ollama 部署集成，在强大的硬件上运行 mixtral。

系统架构

机器配置

• 机器 1 (Booner_Ollama - 10.0.0.10):

  • 在端口 11434 上运行 Ollama LLM 服务器
  • 为 MCP 系统提供 AI 能力
  • 硬件：AMD 5700X3D, 4070 Ti Super, 64GB RAM, Quadro P4000

• 机器 2 (Booner_MCP & booner-mcp-web - 10.0.0.1):

  • 运行 MCP 核心管理 API
  • 运行 Next.js Web 界面
  • 硬件：Ryzen 7 5700X3D, 32GB RAM

• 机器 3 (OPN_IaC - 10.0.0.2):

  • 运行基础设施即代码工具
  • 管理游戏和 Web 服务器的配置

• 部署目标 (机器 N):

  • 运行游戏服务器、Web 应用程序等
  • 硬件示例：
    • Ryzen 5 3600, 32GB RAM
    • E5-2680 v4, 16GB RAM, RTX 3050 8GB

• 存储: TrueNAS，配备 8TB HDD 和 2TB SSD (NFS 共享)

软件栈

• 操作系统: Ubuntu 24 (所有机器)
• LLM: Mixtral 通过 Ollama
• 主要语言: Python, Go, NextJS
• 容器化: Docker

项目结构

• agents/: AI 代理定义和编排代码
• servers/: 用于不同基础设施任务的 MCP 服务器实现
• api/: 用于代理通信的 API 服务器
• config/: 用于不同环境和系统的配置文件
• booner-mcp-web/: 用于管理界面的 Web UI 子模块

设置 & 部署

前提条件

• 支持子模块的 Git
• Docker 和 Docker Compose
• Node.js 18+ (用于本地开发)
• Python 3.11+ (用于本地开发)

初始设置

1. 克隆包含子模块的仓库：

   git clone --recurse-submodules https://github.com/vespo92/Booner_MCP.git
   cd Booner_MCP
   

2. 创建一个环境变量文件：

   cp .env.example .env
   

3. 生成一个安全的 AUTH_SECRET：

   # On Linux/macOS
   ./generate_auth_secret.sh
   
   # On Windows
   .\generate_auth_secret.ps1
   

4. 使用 Docker Compose 部署：

   docker-compose up -d
   

访问服务

• Web UI: http://10.0.0.1:3000
• API: http://10.0.0.1:8000
• Ollama: http://10.0.0.10:11434

开发工作流程

使用主项目

cd Booner_MCP
# 进行更改
git add .
git commit -m "您的提交消息"
git push origin main

使用 Web UI 子模块

cd Booner_MCP/booner-mcp-web
# 进行更改
git add .
git commit -m "您的 Web UI 更改"
git push origin master

# 更新主项目中的子模块引用
cd ..
git add booner-mcp-web
git commit -m "更新 Web UI 子模块"
git push origin main

许可证

[待添加许可证]