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解释量子纠缠”

1. 搜索材料

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

1. 总结主题

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

1. generate_quiz

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

1. 列表主题

- 查看所有可用的教育文档 - 示例：“使用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工具\] \[根据你的材料创建练习题\]

许可证

麻省理工学院