Booner MCP

🚀 Booner_MCP

Model Context Protocol (MCP) をベースとしたAIインフラストラクチャ即コードプラットフォームで、Ollamaを使用してローカルサーバーの管理とスマートコーディングを行います。

🚀 クイックスタート

このプロジェクトは、AIエージェントがModel Context Protocolを通じてローカルインフラストラクチャとやり取りし、Webサーバー、ゲームサーバー、データベースなどのさまざまなタイプのサーバーをデプロイおよび管理することを可能にします。強力なハードウェア上で動作するローカルのOllamaデプロイを統合し、Mixtralモデルを実行します。

✨ 主な機能

• AIエージェントとローカルインフラストラクチャの相互作用を可能にします。
• Model Context Protocolを通じてさまざまなサーバーをデプロイおよび管理します。
• ローカルのOllamaデプロイを統合し、Mixtralモデルを実行します。

🔧 技術詳細

システムアーキテクチャ

マシン構成

• マシン1 (Booner_Ollama - 10.0.0.10)：

  • Ollama LLMサーバーをポート11434で実行します。
  • MCPシステムにAI機能を提供します。
  • ハードウェア：AMD 5700X3Dプロセッサ、NVIDIA 4070 Ti Superグラフィックカード、64GBメモリ、Quadro P4000グラフィックカード

• マシン2 (Booner_MCP & agent - 10.0.0.4)：

  • MCPコア管理APIを実行します。
  • Next.js Webインターフェイスを実行します。
  • ハードウェア：Ryzen 7 5700X3Dプロセッサ、32GBメモリ
  • スマートコーディングのエージェントワークノード

• マシン3 (booner-mcp-web & agent - 10.0.0.4)：

  • Web GUIを実行して、MCPとOllamaとやり取りします。
  • スマートコーディングのエージェントワークノード

• マシン3 (OPN_IaC - 10.0.0.2)：

  • インフラストラクチャ即コードツールを実行します。
  • 専用のOPNSenseネットワークAPI

• デプロイターゲット（マシンN）：

  • ゲームサーバーやWebアプリケーションなどを実行します。
  • ハードウェア例：
    • Intel Xeon E5 - 2680 v4プロセッサ、16GBメモリ、NVIDIA RTX 3050 8GBグラフィックカード

• ストレージ：TrueNASシステム、8TB HDDと2TB SSD（NFSで共有）

ソフトウェアスタック

• オペレーティングシステム：Ubuntu 24（すべてのマシン）
• LLM：Ollamaを通じて実行されるMixtralモデル
• 主要言語：Python、Go、NextJS
• コンテナ化：Docker

プロジェクト構造

• agents/：AIエージェントの定義とオーケストレーションコード
• servers/：さまざまなインフラストラクチャタスク用のMCPサーバー実装
• api/：エージェントと通信するAPIサーバー
• config/：さまざまな環境とシステムの設定ファイル

📦 インストール

前提条件

• サブモジュールをサポートする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を生成します。

   # Linux/macOSでの実行
   ./generate_auth_secret.sh
   
   # 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
# ここでコードの変更や開発活動を行います