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

______________________________________________________________________

🧰 工具概述

______________________________________________________________________

🧱 技术栈

• 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": "",
  "question": "What are the main responsibilities of the company mentioned?",
  "file_type": "pdf"
}

______________________________________________________________________

许可证

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

______________________________________________________________________

⚠️ 免责声明

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

______________________________________________________________________

🧩 定制

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

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

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

______________________________________________________________________

👨‍💻 作者

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