# MCP学术助手
## 基本信息
- Slug: `54yyyu-school-mcp`
- Source: modelscope
- Publisher: @54yyyu/school-mcp
- Categories: education-and-learning-tools / calendar-management
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@54yyyu/school-mcp
## 简介
一种模型上下文协议服务器，通过与Canvas和Gradescope集成，帮助学生管理学术工作流程，以获取截止日期、下载课程材料以及与macOS日历或提醒事项同步。
## 安装提示

```bash
npx -y @smithery/cli install @54yyyu/school-mcp --client claude
```

## MCP Server 详情

# 学校 MCP

[![smithery 徽章](https://smithery.ai/badge/@54yyyu/school-mcp)](https://smithery.ai/server/@54yyyu/school-mcp)

一个用于学术工具的模型上下文协议（MCP）服务器，集成了 Canvas 和 Gradescope 平台。

## 功能

- **作业截止日期**：从 Canvas 和 Gradescope 获取并显示即将到来的截止日期
- **日历集成**：使用 AppleScript 将截止日期添加到 macOS 日历或提醒事项中
- **文件管理**：从 Canvas 下载课程材料

## 快速开始

### 安装

#### 通过 Smithery 安装

要通过 [Smithery](https://smithery.ai/server/@54yyyu/school-mcp) 自动安装 Claude Desktop 的 School MCP：

```bash
npx -y @smithery/cli install @54yyyu/school-mcp --client claude
```


1. 克隆仓库：
```bash
git clone https://github.com/yourusername/school-mcp.git
cd school-mcp
```


2. 安装包：
```bash
pip install -e .
```


3. 设置环境变量，可以通过以下两种方式之一进行：
   - 使用包含的设置助手（推荐）
   - 手动创建 `.env` 文件

### 使用设置助手

运行设置助手以自动配置 Claude Desktop：

```bash
python setup_helper.py
```


设置助手将：
- 查找你的 Claude Desktop 配置文件
- 如果需要，创建一个 `.env` 文件
- 使用正确的路径配置 MCP 服务器
- 将环境变量添加到 Claude Desktop 配置中

### 手动设置

如果你更喜欢手动设置：

1. 复制环境模板：
```bash
cp .env.template .env
# Edit .env with your credentials
```


2. 按照 [Claude Desktop 集成指南](docs/claude_desktop.md)配置 Claude Desktop。

### 运行服务器

直接运行：
```bash
python -m school_mcp
```


或者使用便捷脚本：
```bash
./run_server.py
```


## 工具

- `get_deadlines`：从 Canvas 和 Gradescope 获取即将到来的作业截止日期
- `add_to_reminders`：将作业添加到 macOS 提醒事项
- `list_courses`：列出所有可用的 Canvas 课程
- `download_course_files`：从 Canvas 课程下载文件
- `set_download_path`：配置下载文件的保存位置
- `get_download_path_info`：检查当前的下载位置

## 配置

服务器按以下顺序查找配置：
1. 环境变量
2. 当前目录中的 `.env` 文件
3. 主目录中的现有 `config.json` 文件

## 许可证

MIT