Canvas Learning Management System

🚀 Canvas MCP 服務器

Canvas MCP 服務器實現了與 Canvas 學習管理系統 (LMS) API 對接的消息控制協議 (MCP)，可與 Claude Desktop 及其他潛在 MCP 客戶端配合使用，為用戶提供便捷的 Canvas LMS API 訪問途徑。

🚀 快速開始

Canvas MCP 服務器提供了一個本地接口來訪問 Canvas LMS API，藉助該服務器，您可以輕鬆地列出和管理課程、訪問作業和提交、查看公告、獲取課程大綱和模塊、管理用戶和註冊信息以及生成課程摘要。

✨ 主要特性

• 課程管理：能夠列出和管理課程，方便用戶對課程進行統籌安排。
• 作業與提交訪問：可直接訪問作業和提交情況，便於跟蹤學習進度。
• 公告查看：及時查看課程公告，不錯過重要信息。
• 大綱與模塊獲取：獲取課程大綱和模塊，清晰瞭解課程結構。
• 用戶與註冊管理：管理用戶和註冊信息，保障系統使用的有序性。
• 課程摘要生成：自動生成課程摘要，幫助用戶快速掌握課程要點。

📦 安裝指南

先決條件

• Python 3.x
• 虛擬環境 (venv)
• Canvas API 令牌
• Canvas API URL（例如 https://canvas.illinois.edu/api/v1）

安裝步驟

1. 克隆此倉庫：

git clone https://github.com/vishalsachdev/canvas-mcp.git
cd canvas-mcp

2. 創建並激活虛擬環境：

python -m venv canvas-mcp
source canvas-mcp/bin/activate  # 在 Unix/macOS 上

3. 安裝依賴項：

pip install -r requirements.txt

4. 安裝 MCP 服務器：

pip install .

🔧 配置說明

1. 創建環境文件

在根目錄中創建一個 .env 文件，包含以下變量：

CANVAS_API_TOKEN=your_canvas_api_token_here
CANVAS_API_URL=https://canvas.youruniversity.edu/api/v1

用您實際的值替換：

• 您的 Canvas API 令牌（如何獲取您的 Canvas API 令牌）
• 您所在機構的 Canvas API URL

2. 配置啟動腳本

start_canvas_server.sh 腳本已經配置為：

• 從 .env 文件加載環境變量
• 啟動虛擬環境
• 運行緩存服務器實現

將啟動腳本標記為可執行：

chmod +x start_canvas_server.sh

3. 配置 Claude Desktop

1. 如果尚未安裝，請下載並安裝 Claude Desktop。
2. 打開 Claude 應用，導航到 Settings（設置）。
3. 在左側菜單中選擇 Environment Variables（環境變量）。
4. 添加以下變量：
   • 名稱：CANVAS_API_TOKEN 值：您的 Canvas API 令牌
   • 名稱：CANVAS_API_URL 值：您機構的 Canvas API URL

💻 使用示例

基礎用法

啟動 MCP 服務器：

python -m canvas_mcp.server

⚠️ 安全考慮

⚠️ 重要提示

• 您的 Canvas API 令牌授予訪問您的 Canvas 帳戶的權限，務必妥善保管。
• 切勿將 .env 文件提交到版本控制系統中，防止信息洩露。
• 考慮使用權限受限的令牌（如果可能），降低安全風險。
• 該服務器在您本地計算機上運行，不會對外暴露您的憑證，但仍需注意本地安全。

🤝 貢獻說明

歡迎貢獻！請隨意：

• 提交問題報告錯誤或功能請求
• 創建拉取請求以改進項目
• 分享您的用例和反饋

📄 許可證

該項目使用 MIT 許可證 - 有關詳細信息，請參閱 LICENSE 文件。

由 Vishal Sachdev 創建