54yyyu_school_mcp

54yyyu_school_mcp

by 54yyyu
An MCP server for academic tools, integrating with Canvas and Gradescope platforms.

Academic Tools Integration MCP Server

Overview

The Academic Tools Integration MCP Server is a Model Context Protocol (MCP) server designed to streamline academic workflows by integrating with popular platforms like Canvas and Gradescope. It provides tools to manage assignments, deadlines, and course materials efficiently.

Features

  • Assignment Deadlines: Fetch and display upcoming deadlines from Canvas and Gradescope.
  • Calendar Integration: Add deadlines to macOS Calendar or Reminders using AppleScript.
  • File Management: Download course materials from Canvas.

Quickstart

Installation

  1. Clone the repository:
    shell git clone https://github.com/yourusername/school-mcp.git cd school-mcp
  2. Install the package:
    shell pip install -e .
  3. Set up your environment variables by either:
  4. Using the included setup helper (recommended)
  5. Creating a .env file manually

Using the Setup Helper

Run the setup helper to configure the MCP server automatically:

python setup_helper.py

The setup helper will:
- Find your Claude Desktop configuration file
- Create a .env file if needed
- Configure the MCP server with proper paths
- Add your environment variables to the Claude Desktop configuration

Manual Setup

If you prefer to set up manually:
1. Copy the environment template:
shell cp .env.template .env # Edit .env with your credentials
2. Configure Claude Desktop by following the Claude Desktop Integration Guide.

Running the Server

Run directly:

python -m school_mcp

Or use the convenience script:

./run_server.py

Tools

  • get_deadlines: Fetch upcoming assignment deadlines from Canvas and Gradescope.
  • add_to_reminders: Add assignments to macOS Reminders.
  • list_courses: List all available Canvas courses.
  • download_course_files: Download files from a Canvas course.
  • set_download_path: Configure where downloaded files are saved.
  • get_download_path_info: Check the current download location.

Configuration

The server tries to find configuration in this order:
1. Environment variables
2. .env file in the current directory
3. Existing config.json file in the home directory

License

MIT

About

The Academic Tools Integration MCP Server is designed to enhance productivity for students and educators by integrating with Canvas and Gradescope platforms.

Topics

Resources

Stars

3 stars

Watchers

1 watching

Forks

0 forks

Report repository

Releases

No releases published

Packages

No packages published

Languages

Features & Capabilities

Categories
mcp_server model_context_protocol python canvas gradescope claude api_integration file_management calendar_integration

Implementation Details

Stats

0 Views
0 Likes
3 GitHub Stars

Repository Info

54yyyu Organization

Similar Servers

continuedev_continue by continuedev
0
0
0