AI导哈

智能学习助手

一个智能代理系统，自动处理手写课堂笔记，将其整理到Notion中，并根据您的学习风格生成个性化的每日学习计划。

  • by MukileshT
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 MukileshT/study-assistant-mcp

使用说明

使用MCP的AI研究助理

一个智能代理系统，可以自动处理手写的课堂笔记，在Notion中组织它们，并根据你的学习风格生成个性化的日常学习计划。

特性

  • 自动笔记数字化 -上传手写笔记的照片
  • AI驱动的分析 -提取关键概念、摘要和结构
  • 概念整合 -具有丰富格式的有序存储
  • 个性化规划 -根据您的学习风格制定每日学习计划
  • 智能优先级 -专注于最重要的事情
  • 100%免费 -使用免费层API（Gemini、Groq）

建筑

Photo → Image Processing → OCR (Gemini Vision) → Text Analysis (Groq) → Formatting → Notion Storage → Study Analysis → Daily Plan Generation (Gemini Pro) → Notion

快速开始

先决条件

  • Python 3.11或更高版本
  • 通知帐户
  • API密钥（全部免费）：
    • 谷歌人工智能工作室（Gemini）
    • Groq Cloud
    • 概念整合

安装

  1. 克隆存储库
git clone https://github.com/MukileshT/study-assistant-mcp.git
cd study-assistant-mcp
  1. 创建虚拟环境
python -m venv .venv
.venv\Scripts\activate
  1. 安装依赖项
pip install -r requirements.txt
  1. 设置环境变量
cp .env.example .env
# Edit .env with your API keys

  1. 获取API密钥

    Gemini（谷歌人工智能工作室）：

    • 访问：https://ai.google.dev
    • 点击“获取API密钥”
    • 复制到 .env 作为 GOOGLE_API_KEY

    Groq：

    • 访问：https://console.groq.com
    • 注册并获取API密钥
    • 复制到 .env 作为 GROQ_API_KEY

    概念：

    • 访问：https://www.notion.so/my-integrations
    • 创建新的集成
    • 将令牌复制到 .env 作为 NOTION_API_KEY
    • 在Notion中创建数据库并与您的集成共享
    • 将数据库ID复制到 .env 作为 NOTION_DATABASE_ID

  2. 初始化Notion工作区

python scripts/setup_notion.py

用法

上传和处理笔记

# Process a single image
python -m src.main process image.jpg

# Process multiple images
python -m src.main process note1.jpg note2.jpg note3.jpg

# Process all images in a folder
python -m src.main process ./my-notes/

制定每日学习计划

# Generate plan for tomorrow
python -m src.main plan

# Generate plan for specific date
python -m src.main plan --date 2024-01-15

配置首选项

# Set learning style
python -m src.main config --learning-style visual

# Set note detail level
python -m src.main config --detail-level detailed

# View current settings
python -m src.main config --show

🎨 定制

学习风格

选择你的学习风格 config/user_preferences.json:

  • 视觉的 -强调图表、图表、思维导图
  • 听觉的 -注重口头解释、总结
  • 动觉 -练习问题，动手示例
  • 阅读与书写 -详细的文本、列表、定义

注释模板

在中自定义Notion模板 config/notion_templates.py:

  • 标题样式
  • 元数据字段
  • 配色方案
  • 组织结构

发展

项目结构

study-assistant-mcp/
├── config/          # Configuration files
├── src/
│   ├── core/       # Main agent & orchestration
│   ├── models/     # AI model clients
│   ├── processors/ # Image & text processing
│   ├── storage/    # Notion & database
│   ├── planning/   # Study planning logic
│   └── utils/      # Utilities
├── scripts/        # Setup & automation scripts
├── tests/          # Unit tests
└── data/           # Local cache & uploads

运行测试

# Run all tests
pytest

# Run with coverage
pytest --cov=src tests/

# Run specific test file
pytest tests/test_image_processing.py

代码质量

# Format code
black src/

# Lint
flake8 src/

# Type checking
mypy src/

演出

  • 纸币处理： 每张图片约5-10秒
  • 每日计划生成： 约3-5秒
  • API成本： 0.00美元（免费套餐）
  • 每日限额： 约50张钞票，1个计划（完全在免费配额范围内）

贡献

欢迎投稿！拜托：

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 添加测试
  5. 提交拉取请求

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件

致谢

  • API双子星 通过谷歌
  • Groq 用于快速推理
  • 概念 令人惊叹的组织工具
  • 主控程序 （模型上下文协议）

即将到来的

  • []移动应用支持
  • []语音笔记处理
  • []合作研究小组
  • []闪存卡生成
  • []测验创建
  • []进度跟踪仪表板

制作💖 适合那些想更聪明地学习而不是更努力的学生

相关 MCP