ScholarMind

面向大模型 Agent 领域的多模态学术研究助手。它可以安装到任意 MCP 宿主中，辅助完成论文检索、PDF/图表理解、知识图谱沉淀、学习路径规划和代码复现实验。

Feature 亮点

功能	描述
论文检索	双源检索 Semantic Scholar + arXiv，遇到 429 自动降级
多模态理解	解析论文图表、表格、系统架构图和实验曲线，按需触发以控制 token 成本
知识图谱	阅读论文后自动构建个人学术知识网络，使用 Pydantic Schema 约束结构化输出
学习规划	基于知识盲区检测和 PageRank 分析，推荐下一步阅读与补强路径
代码复现	将论文方法转化为可执行的实验或原型代码，并在沙箱中运行验证

项目定位

ScholarMind 当前聚焦大模型 Agent 研究，适合围绕以下主题建立可持续积累的研究工作流：

• LLM Agent 架构、规划、反思、工具使用和多 Agent 协作
• 长期记忆、RAG、知识图谱和上下文管理
• Agent benchmark、评测闭环、可复现实验和工程框架
• ReAct、MemGPT、Generative Agents、AutoGen、LangGraph 等代表性论文与系统

Architecture

ScholarMind/
├── CLAUDE.md                   <- 宿主入口文档
├── install.py                  <- 一键安装脚本
├── mcp_config.example.json     <- MCP 注册模板
├── memory/                     <- 文件系统记忆
│   ├── MEMORY.md               <- 经验记忆
│   ├── USER.md                 <- 用户画像
│   ├── experiences/            <- 搜索策略、分析模式等经验
│   └── knowledge_export/       <- 图谱可读导出
├── .agents/workflows/          <- 工作流脚本
│   ├── paper-analysis.md       <- /paper-analysis
│   ├── knowledge-build.md      <- /knowledge-build
│   ├── paper-watch.md          <- /paper-watch
│   └── simulation.md           <- /simulation
├── skills/                     <- Skills 与 CLI 脚本
│   ├── paper_reader/           <- PDF -> 文本 + 图表
│   ├── learning_path/          <- 盲区检测 + 路径规划
│   └── paper_watch/            <- 论文追踪
├── src/
│   ├── mcp_servers/            <- MCP Server
│   ├── core/                   <- PDF 解析、多模态图表分析等核心能力
│   ├── knowledge/              <- 知识图谱 Schema、抽取、存储、分析
│   ├── report/                 <- 结构化研究报告与仪表盘
│   └── execution/              <- 代码沙箱与实验模板
├── prompts/                    <- Prompt 模板库
└── tests/                      <- 测试套件

Quick Start

1. 克隆并安装依赖

git clone https://github.com/Jennyee1/AcademicAgent.git
cd AcademicAgent
pip install -r requirements.txt

2. 配置 API Key

cp .env.example .env   # Windows: copy .env.example .env
# 编辑 .env，填入 MINIMAX_API_KEY

3. 一键安装

python install.py

安装脚本会检查关键文件、创建 data/ 目录、生成 mcp_config.json，并输出注册到 MCP 宿主的指引。

4. 注册到宿主

将生成的 mcp_config.json 内容合并到你的宿主配置：

宿主	配置文件位置
Antigravity	~/.gemini/antigravity/mcp_config.json
Claude Code	~/.claude/mcp_config.json

5. 开始使用

> "帮我搜索关于 LLM Agent memory 的最新论文"
> "分析这篇 ReAct 论文，并把核心概念写入知识图谱"
> /paper-analysis
> /knowledge-build

Tech Stack

类别	技术
协议	MCP (Model Context Protocol)
PDF 解析	PyMuPDF，Generator 模式防 OOM
知识图谱	NetworkX + Pydantic Structured Output + 时间维度
检索	TF-IDF 语义检索 + 关键词回退
论文搜索	Semantic Scholar API + arXiv API 自动降级
记忆	Hermes-style MEMORY.md + USER.md + Markdown 导出
实验执行	subprocess 沙箱 + numpy/scipy/matplotlib

Memory System

项目借鉴 Hermes Agent、ReMe、MemU、Zep/Graphiti 等记忆框架，实现轻量级文件系统记忆：

记忆层	实现	灵感来源
用户画像	memory/USER.md	用户研究偏好建模
经验记忆	memory/MEMORY.md	Hermes MEMORY.md + ReMe
时间维度	schema.py 时间字段	Zep/Graphiti 时序图谱
语义检索	graph_store.py TF-IDF	ReMe hybrid retrieval
可审计导出	export_to_markdown()	MemU 文件系统记忆

GitHub Description 建议

用于仓库简介的一句话可以写成：

A multimodal academic research Agent for LLM Agent papers: search, PDF/figure understanding, knowledge graph memory, learning paths, and reproducible experiments via MCP.

License

MIT