AI导哈

AI教育辅导服务器

一个基于本地教育材料的AI辅导服务器，可自动索引和读取文档、解释概念、生成测验题目、总结主题内容以及搜索关键词。

  • by argotdev
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 argotdev/tutor-mcp-ts

使用说明

MCP导师服务器

一个模型上下文协议（MCP）服务器，根据您当地的教育材料（包括课堂讲稿、讲义和教科书）充当人工智能导师。

特性

  • 文档访问：自动索引和读取教育材料（PDF、TXT、MD）
  • 概念解释：根据你的材料获得概念的解释
  • 练习测验：针对特定主题生成测验问题
  • 主题摘要：创建简短或详细的主题摘要
  • 材质搜索：在所有材料中搜索特定关键字
  • 资源列表：浏览所有可用的教育文档

安装

  1. 安装依赖项：
npm install
  1. 构建服务器：
npm run build

设置

1.准备材料目录

为您的教育材料创建一个目录并添加文件：

mkdir materials

将文件添加到此目录：

  • 课堂讲稿（.txt、.md）
  • 讲义（.pdf、.txt、.md）
  • 教科书章节（.pdf）
  • 学习指南（.md、.txt）

示例结构：

materials/
  ├── lectures/
  │   ├── week1-introduction.md
  │   └── week2-advanced-topics.pdf
  ├── textbooks/
  │   ├── chapter1.pdf
  │   └── chapter2.pdf
  └── handouts/
      └── study-guide.txt

2.配置克劳德桌面

将服务器添加到Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tutor": {
      "command": "node",
      "args": ["/absolute/path/to/tutor/dist/index.js"],
      "env": {
        "TUTOR_MATERIALS_PATH": "/absolute/path/to/your/materials"
      }
    }
  }
}

用实际路径替换路径。

3.重新启动克劳德桌面

更新配置后，重新启动Claude Desktop以使更改生效。

用法

配置后，您可以使用Claude Desktop中的辅导工具：

可用工具

  1. 解释概念

    • 根据您的材料解释概念
    • 示例：“使用explain_centrepreneur解释量子纠缠”

  2. 搜索材料

    • 在所有材料中搜索关键字
    • 示例：“使用search_materials查找对‘神经网络’的引用”

  3. 总结主题

    • 从你的材料中总结一个主题
    • 示例：“使用summarize_topic总结机器学习基础知识”

  4. generate_quiz

    • 就某个主题创建练习题
    • 示例：“使用generate_quiz创建5个关于算法的问题”

  5. 列表主题

    • 查看所有可用的教育文档
    • 示例：“使用list_targets查看可用的材料”

可用资源

服务器还将您的所有文档作为克劳德可以直接读取的资源公开：

  • 每个文档显示为 tutor:///path/to/document
  • 克劳德可以阅读这些内容以提供详细的答案

环境变量

  • TUTOR_MATERIALS_PATH：材料目录的路径（默认： ./materials)

发展

开发观察模式：

npm run dev

生产建设：

npm run build

支持的文件格式

  • 文本文件：.txt、.md、.markdown
  • PDF文件：.pdf（文本提取）

提示

  1. 整理你的材料：使用子目录按课程、主题或周组织材料
  2. 清除文件名：使用反映内容的描述性文件名
  3. 定期更新：收到新材料时添加新材料
  4. 文本格式：为了获得最佳效果，尽可能使用markdown或文本文件（处理速度更快）

故障排除

未找到材料

如果服务器报告没有材料：

  1. 检查一下 TUTOR_MATERIALS_PATH 设置正确
  2. 验证目录是否存在
  3. 确保文件采用支持的格式
  4. 检查文件权限

PDF阅读问题

如果PDF阅读不正确：

  1. 确保PDF包含文本（而不仅仅是图像）
  2. 对于扫描的文档，请先使用OCR软件
  3. 检查pdf解析是否安装正确

服务器未启动

  1. 检查克劳德桌面日志
  2. 验证是否已安装所有依赖项
  3. 确保index.js的路径正确
  4. 尝试手动运行服务器： node dist/index.js

交互示例

用户：“我需要帮助理解课堂讲稿中的概念”

克劳德：“我会帮你的。让我先看看有什么材料。” [使用列表主题工具]

克劳德：“我可以看到你关于量子力学的讲义。你想让我解释什么具体的概念？”

用户：“你能解释波粒二象性吗？”

克劳德：[使用具有“波粒二象性”的解释概念工具] [返回您的材料和解释的相关摘录]

用户：“你能就这个话题对我进行测试吗？”

克劳德：[使用generate_quiz工具] [根据你的材料创建练习题]

许可证

麻省理工学院

相关 MCP