MCP

🚀 Jeneen的MCP智能體

本項目是一個基於FastMCP構建的多功能AI智能體。它具備以下功能：

• ✅ 一個阿拉伯語法律聊天機器人，可回答常見法律問題。
• 🔍 一個谷歌搜索工具。
• 🧬 一個變分自編碼器（VAE）模型，用於生成手寫數字圖像。

🚀 快速開始

運行步驟

1. 創建並激活虛擬環境

python -m venv .venv
source .venv/bin/activate    # 在Windows上使用：.venv\Scripts\activate

2. 安裝依賴

pip install -r requirements.txt

3. （可選）使用VAE.ipynb訓練VAE模型，或者使用output/vae_epoch_50.pth中的預訓練模型。
4. 運行MCP智能體

python main.py

✨ 主要特性

• 提供阿拉伯語法律聊天機器人，能解答如年假、離婚、監護權、就業權利和租賃協議等常見法律問題。
• 集成谷歌搜索工具，可在默認瀏覽器中打開谷歌搜索。
• 利用變分自編碼器（VAE）模型生成手寫數字圖像。

📦 安裝指南

虛擬環境創建與激活

python -m venv .venv
source .venv/bin/activate    # 在Windows上使用：.venv\Scripts\activate

依賴安裝

pip install -r requirements.txt

💻 使用示例

基礎用法

法律聊天機器人

{ "tool": "legal_chat", "input": "ما هي حقوقي في حال الطلاق؟" }

谷歌搜索工具

{ "tool": "search_google", "input": "قانون العمل الأردني" }

VAE模型生成手寫數字圖像

{ "tool": "vae_generate", "input": { "n_images": 8 } }

📚 詳細文檔

📁 項目結構

├── main.py # 運行MCP智能體的主腳本
├── chatbot.py # 阿拉伯語法律聊天機器人邏輯
├── vae_model.py # VAE模型定義（編碼器、解碼器、VAE）
├── output/ # 模型檢查點和生成的圖像
├── data/ # MNIST數據集（自動下載）
├── VAE.ipynb # 用於訓練VAE模型的Jupyter筆記本
└── README.md # 本文檔文件

⚙️ 可用的MCP工具

1. legal_chat(query: str) → str

這是一個阿拉伯語聊天機器人，可回答以下法律問題：

• 年假
• 離婚
• 監護權
• 就業權利
• 租賃協議 示例：

{ "tool": "legal_chat", "input": "ما هي حقوقي في حال الطلاق؟" }

2. search_google(query: str) → str

該工具會在默認瀏覽器中打開谷歌搜索。 示例：

{ "tool": "search_google", "input": "قانون العمل الأردني" }

3. vae_generate(n_images: int) → str

使用訓練好的VAE模型生成手寫數字圖像，並返回一個Base64編碼的PNG圖像。 示例：

{ "tool": "vae_generate", "input": { "n_images": 8 } }