article
README
🚀 Jeneen的MCP智能体
本项目是一个基于FastMCP构建的多功能AI智能体。它具备以下功能:
- ✅ 一个阿拉伯语法律聊天机器人,可回答常见法律问题。
- 🔍 一个谷歌搜索工具。
- 🧬 一个变分自编码器(VAE)模型,用于生成手写数字图像。
🚀 快速开始
运行步骤
- 创建并激活虚拟环境
python -m venv .venv
source .venv/bin/activate # 在Windows上使用:.venv\Scripts\activate
- 安装依赖
pip install -r requirements.txt
- (可选)使用
VAE.ipynb训练VAE模型,或者使用output/vae_epoch_50.pth中的预训练模型。 - 运行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 } }
微信扫一扫