使用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 - 概念整合
安装
- 克隆存储库
git clone https://github.com/MukileshT/study-assistant-mcp.git
cd study-assistant-mcp- 创建虚拟环境
python -m venv .venv
.venv\Scripts\activate- 安装依赖项
pip install -r requirements.txt- 设置环境变量
cp .env.example .env
# Edit .env with your API keys- 获取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
- 初始化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个计划（完全在免费配额范围内）
贡献
欢迎投稿！拜托：
- 分叉存储库
- 创建要素分支
- 进行更改
- 添加测试
- 提交拉取请求
📄 许可证
MIT许可证-有关详细信息，请参阅许可证文件
致谢
- API双子星 通过谷歌
- Groq 用于快速推理
- 概念 令人惊叹的组织工具
- 主控程序 （模型上下文协议）
即将到来的
- \[\]移动应用支持
- \[\]语音笔记处理
- \[\]合作研究小组
- \[\]闪存卡生成
- \[\]测验创建
- \[\]进度跟踪仪表板
______________________________________________________________________
制作💖 适合那些想更聪明地学习而不是更努力的学生