AI健康与文档问答平台

一个基于Groq LLaMA 3.1的模块化对话平台,提供健康检查、文档问答、知识助手、饮食营养、心理健康支持、紧急指导和健身建议等功能。

  • by GVKarthik-dev
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 gvkarthik-dev/mcp-puchai-hackathon

使用说明

#BuildWithPuch

🧠 Groq人工智能知识、文档问答和健康助理MCP

这是一个模块化对话平台(MCP),由 FastMCP, Groq Calma 3.1(8b) 通过 ChatGroq,并与文档解析、健康工具和各种领域的AI助手集成,包括:

  • ✅ 健康检查
  • 📄 文件问答(PDF/DOCX)
  • 📘 知识助理
  • 🥗 饮食与营养
  • 🧠 心理健康支持
  • 🚨 紧急指令
  • 🏋️‍♂️ 运动与健身指导

🚀 特性

  • ✅ 人工智能生成了带有安全免责声明的健康响应。
  • 📄 上传和查询自然语言的文档(PDF、DOCX)。
  • 🔍 问一些常识问题。
  • 🧘 心理健康和情感支持。
  • 🥗 营养提示和饮食计划。
  • 🆘 急救应急响应说明。
  • 🏃‍♂️ 锻炼和健身建议。
  • 🧩 模块化设计,带有干净的快速构建器和异步工具。

🛠️ 安装说明

1.克隆存储库

git clone https://github.com/GVKarthik-dev/MCP-PuchAI-Hackathon.git
cd MCP-PuchAI-Hackathon

2.安装依赖项

注: 确保已安装Python 3.9+ 紫外线

uv sync

3.创建环境文件

创建一个 .env 根目录中的文件 Groq API 密钥 以及任何其他所需的秘密:

GROQ_API_KEY=YOUR_GROQ_API_KEY

4.运行服务器

uv run python Server.py

服务器将在以下时间启动: http://localhost:8000


🧰 工具概述

工具 说明
health_check 回答用户健康查询。
upload_and_qa 解析上传的文档并根据上下文回答问题。
ask_knowledge 提供任何主题的详细解释。
diet_and_nutrition 提供有关营养和健康饮食的建议和技巧。
mental_health_support 以情感支持和应对策略作为回应。
emergency_instructions 为紧急情况提供分步急救指导。
exercise_and_fitness 提供健身建议和恢复技巧。

🧱 技术栈

  • FastMCP -模块化会话框架
  • ChatGroq 的 -与Groq快速的LLaMA 3.1型号集成
  • pdfplumber -从PDF中提取文本
  • python-docx -阅读 .docx 文件
  • dotenv -加载环境变量
  • eunomia_mcp -Eunomia基于策略的中间件

🧪 示例用法

健康问题

{
  "tool": "health_check",
  "query": "What should I do if I have a mild fever?"
}

文件问答

{
  "tool": "upload_and_qa",
  "doc_base64": "<base64-encoded-pdf-or-docx>",
  "question": "What are the main responsibilities of the company mentioned?",
  "file_type": "pdf"
}

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。


⚠️ 免责声明

  • 健康和心理支持信息是 不 专业医疗建议的替代品。
  • 应急说明旨在提高急救和意识,而不是作为认证培训。

🧩 定制

您可以通过扩展来添加更多工具或提示:

  • 快速构建器(功能如 build_*_prompt)
  • 工具功能(@mcp.tool)

所有提示生成都是模块化的,易于修改。


👨‍💻 作者

与开发❤️ 使用FastMCP和Groq LLM。