Tutor MCP Python

MCP导师服务器（Python）

一个作为模型上下文协议（MCP）服务器运行的人工智能辅导系统，允许Claude访问您当地的教育材料并与之交互，从而根据您的实际课程内容提供个性化辅导。

特性

• 隐私第一：你所有的教育材料都保存在你的本地机器上
• 通用格式支持：适用于PDF、Markdown和文本文件
• 智能搜索：在所有材料中查找概念和解释
• 互动式教学法：生成测验、总结和详细解释
• 资源访问：克劳德可以阅读完整的文档以获得全面的答案

它做什么

导师服务器为克劳德提供了5个强大的工具：

1. 解释概念 -从材料中搜索并解释具体概念
2. 搜索材料 -在所有具有上下文的文档中进行全文搜索
3. 总结主题 -生成主题的简短或详细摘要
4. generate_quiz -创建不同难度级别的练习题
5. 列表主题 -浏览所有可用的教育材料

您的所有文档也都作为资源公开，允许Claude在需要时读取完整的文件。

安装

先决条件

• Python 3.10或更高版本
• Claude桌面应用程序

设置

1. 克隆或下载此目录：

cd tutor-mcp-python

1. 安装软件包：

pip install -e .

或使用紫外线（推荐）：

uv pip install -e .

1. 配置Claude桌面：

编辑您的Claude Desktop配置文件：

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

添加导师服务器：

{
  "mcpServers": {
    "tutor": {
      "command": "python",
      "args": ["-m", "tutor_mcp.server"],
      "env": {
        "TUTOR_MATERIALS_PATH": "/absolute/path/to/materials"
      }
    }
  }
}

或者，如果全局安装：

{
  "mcpServers": {
    "tutor": {
      "command": "tutor-mcp",
      "env": {
        "TUTOR_MATERIALS_PATH": "/absolute/path/to/materials"
      }
    }
  }
}

1. 添加您的教育材料：

创建一个 materials 目录并添加您的文件：

materials/
├── computer-science/
│   ├── algorithms.pdf
│   └── data-structures.md
├── mathematics/
│   └── calculus-notes.txt
└── physics/
    └── quantum-mechanics.pdf

1. 重新启动克劳德桌面

用法

配置后，您可以向Claude询问有关材料的问题：

• “根据我的材料解释二叉搜索树的概念”
• “在我的笔记中搜索有关量子纠缠的信息”
• “生成一个包含5个中等难度问题的递归测验”
• “总结我的材料对大O符号的看法”
• “我有什么主题的材料？”

Claude将使用导师服务器访问您的文件，并根据您的实际课程内容提供个性化答案。

支持的文件格式

• .txt -纯文本文件
• .md, .markdown -Markdown文件
• .pdf -PDF文档（文本提取）

配置

环境变量

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

材料目录

按照你喜欢的方式组织你的材料。服务器将：

• 递归扫描所有子目录
• 索引所有支持的文件类型
• 使它们可供克劳德搜索和访问

发展

从源头运行

python -m tutor_mcp.server

运行测试

pip install -e ".[dev]"
pytest

项目结构

tutor-mcp-python/
├── src/
│   └── tutor_mcp/
│       ├── __init__.py
│       └── server.py          # Main server implementation
├── materials/                  # Your educational materials
├── pyproject.toml             # Project configuration
└── README.md

运作原理

1. 初创公司：服务器为物料目录中的所有文档建立索引
2. 连接：Claude Desktop通过stdio传输连接
3. 查询：你问克劳德的教育问题
4. 工具使用：Claude调用导师工具进行搜索/总结/解释
5. 响应：服务器返回带有上下文的相关内容
6. 回答：克劳德将信息综合成有用的回答

隐私和安全

• 所有数据都保留在本地计算机上
• 不向外部服务发送任何材料
• Claude仅通过MCP协议访问文件
• 您可以精确控制可访问的目录

故障排除

服务器未出现在Claude Desktop中

1. 检查配置文件语法（有效的JSON）
2. 验证Python是否在您的PATH中
3. 检查Claude Desktop日志是否有错误
4. 完全重新启动克劳德桌面

未找到材料

1. 验证 TUTOR_MATERIALS_PATH 是一条绝对路径
2. 检查目录是否存在并包含支持的文件
3. 确保文件扩展名为小写或受支持（.txt、.md、.pdf）

PDF文本提取问题

某些PDF（尤其是扫描图像）可能无法正确提取文本。为了获得最佳效果：

• 使用基于文本的PDF，而不是扫描图像
• 考虑使用OCR转换扫描的PDF
• 或者，手动将文本提取到.txt或.md文件中

许可证

麻省理工学院

贡献

欢迎投稿！这是一个开源项目，旨在帮助学生在人工智能的帮助下更好地学习。

致谢

内置：

• 模型上下文协议 -MCP-SDK
• pypdf -PDF文本提取
• 克劳德 -人工智能助手Anthropic