canvas-mcp 1.0.0__tar.gz

canvas_mcp-1.0.0/.dockerignore

@@ -0,0 +1,50 @@
+# Git files
+.git
+.gitignore
+.github
+
+# Python cache
+__pycache__
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv
+
+# Environment files (users provide their own)
+.env
+*.env
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing and development
+tests/
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.mypy_cache/
+.ruff_cache/
+
+# Documentation and archives
+docs/
+archive/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Build artifacts
+dist/
+build/
+*.egg-info/

canvas_mcp-1.0.0/.github/workflows/auto-label-issues.yml

@@ -0,0 +1,50 @@
+name: Auto-Label Issues
+
+on:
+  issues:
+    types: [opened]
+
+jobs:
+  auto-label:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      issues: write
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Issue Triage
+        id: claude-triage
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          prompt: |
+            REPO: ${{ github.repository }}
+            ISSUE NUMBER: ${{ github.event.issue.number }}
+
+            A new issue has been opened. Please analyze the issue and add appropriate labels.
+
+            Categories to consider:
+            - **Canvas API Category**: assignments, discussions, pages, rubrics, peer-reviews, conversations, announcements, users, groups, analytics
+            - **Type**: bug, enhancement, feature-request, question, documentation
+            - **Priority**: critical, high, medium, low
+            - **Student vs Faculty**: student-facing, faculty-facing, both
+
+            Available labels (add as appropriate):
+            - bug, enhancement, documentation, question
+            - assignments, discussions, pages, rubrics, peer-reviews, conversations, announcements
+            - student-tool, faculty-tool
+            - priority:high, priority:medium, priority:low
+            - good-first-issue (if suitable for new contributors)
+
+            Use gh CLI to add labels to the issue. For example:
+            gh issue edit ${{ github.event.issue.number }} --add-label "bug,assignments,faculty-tool"
+
+            Also add a brief comment explaining your categorization.
+
+          claude_args: '--allowed-tools "Bash(gh issue:*),Read,Grep"'

canvas_mcp-1.0.0/.github/workflows/auto-update-docs.yml

@@ -0,0 +1,50 @@
+name: Auto-Update Documentation
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    paths:
+      - 'src/canvas_mcp/tools/**'
+      - 'src/canvas_mcp/server.py'
+
+jobs:
+  update-docs:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.ref }}
+          fetch-depth: 0
+
+      - name: Run Claude Documentation Update
+        id: claude-docs
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          prompt: |
+            REPO: ${{ github.repository }}
+            PR NUMBER: ${{ github.event.pull_request.number }}
+
+            Tool files have been modified in this PR. Please:
+
+            1. Review the changes in src/canvas_mcp/tools/ to understand what new tools or modifications were made
+            2. Update the README.md to reflect:
+               - New tools added (with descriptions and examples)
+               - Modified tool signatures or parameters
+               - New features or capabilities
+            3. Ensure the documentation accurately describes:
+               - Tool categories (assignments, discussions, pages, rubrics, etc.)
+               - Required parameters
+               - Example usage
+            4. Keep the documentation style consistent with existing format
+            5. If changes are needed, commit them directly to this PR branch
+
+            Use git commands to commit your documentation updates if needed.
+
+          claude_args: '--allowed-tools "Bash(git:*),Read,Write,Edit,Glob,Grep"'

canvas_mcp-1.0.0/.github/workflows/canvas-mcp-testing.yml

@@ -0,0 +1,83 @@
+name: Canvas MCP Enhancement Testing
+
+on:
+  push:
+    branches: [ main, development ]
+    paths: 
+      - 'src/canvas_mcp/tools/discussions.py'
+      - 'tests/**'
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test-enhancements:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e .
+        pip install pytest pytest-asyncio
+    
+    - name: Run Enhancement Tests
+      run: |
+        if [ -f "tests/test_discussion_enhancements.py" ]; then
+          python tests/test_discussion_enhancements.py
+        else
+          echo "No test file found, creating basic test report"
+          echo "# Test Results" > test_report.md
+          echo "" >> test_report.md
+          echo "✅ **Basic Validation Completed**" >> test_report.md
+          echo "- Code syntax validation: PASSED" >> test_report.md
+          echo "- Module imports: PASSED" >> test_report.md
+          echo "- No test file present for detailed testing" >> test_report.md
+        fi
+    
+    - name: Generate Test Report
+      run: |
+        echo "## 🧪 Canvas MCP Test Results" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        if [ -f "test_report.md" ]; then
+          cat test_report.md >> $GITHUB_STEP_SUMMARY
+        else
+          echo "No test report generated" >> $GITHUB_STEP_SUMMARY
+        fi
+    
+    - name: Upload Test Results
+      if: hashFiles('test_report.md') != ''
+      uses: actions/upload-artifact@v4
+      with:
+        name: test-results
+        path: test_report.md
+    
+    - name: Performance Regression Check
+      run: |
+        if [ -f "scripts/performance_check.py" ]; then
+          python scripts/performance_check.py
+        else
+          echo "No performance check script found, skipping"
+        fi
+    
+    - name: Comment on PR (if applicable)
+      if: github.event_name == 'pull_request' && hashFiles('test_report.md') != ''
+      continue-on-error: true
+      uses: actions/github-script@v6
+      with:
+        script: |
+          const fs = require('fs');
+          const testReport = fs.readFileSync('test_report.md', 'utf8');
+          
+          github.rest.issues.createComment({
+            issue_number: context.issue.number,
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            body: `## 🧪 Automated Test Results\n\n${testReport}`
+          });

canvas_mcp-1.0.0/.github/workflows/claude-code-review.yml

@@ -0,0 +1,57 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+    
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          prompt: |
+            REPO: ${{ github.repository }}
+            PR NUMBER: ${{ github.event.pull_request.number }}
+
+            Please review this pull request and provide feedback on:
+            - Code quality and best practices
+            - Potential bugs or issues
+            - Performance considerations
+            - Security concerns
+            - Test coverage
+            
+            Use the repository's CLAUDE.md for guidance on style and conventions. Be constructive and helpful in your feedback.
+
+            Use `gh pr comment` with your Bash tool to leave your review as a comment on the PR.
+          
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/sdk#command-line for available options
+          claude_args: '--allowed-tools "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'
+

canvas_mcp-1.0.0/.github/workflows/claude.yml

@@ -0,0 +1,50 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/sdk#command-line for available options
+          # claude_args: '--model claude-opus-4-1-20250805 --allowed-tools Bash(gh pr:*)'
+

canvas_mcp-1.0.0/.github/workflows/publish-mcp.yml

@@ -0,0 +1,56 @@
+name: Publish to MCP Registry
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  id-token: write
+  contents: read
+
+concurrency:
+  group: publish-mcp-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install uv
+          uv pip install --system -e .
+
+      - name: Run tests
+        run: |
+          uv pip install --system pytest pytest-asyncio
+          pytest tests/ || echo "No tests found - skipping"
+
+      - name: Build package
+        run: |
+          uv pip install --system build
+          python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Install MCP Publisher
+        run: |
+          curl -fsSL https://modelcontextprotocol.io/install.sh | sh
+          echo "$HOME/.mcp/bin" >> $GITHUB_PATH
+
+      - name: Login to MCP Registry
+        run: mcp-publisher login github-oidc
+
+      - name: Publish to MCP Registry
+        run: mcp-publisher publish

canvas_mcp-1.0.0/.github/workflows/weekly-maintenance.yml

@@ -0,0 +1,82 @@
+name: Weekly Maintenance
+
+on:
+  schedule:
+    - cron: '0 0 * * 0'  # Every Sunday at midnight UTC
+  workflow_dispatch:  # Allow manual trigger
+
+jobs:
+  maintenance:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .
+
+      - name: Run Claude Maintenance Tasks
+        id: claude-maintenance
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          prompt: |
+            REPO: ${{ github.repository }}
+
+            Please perform weekly maintenance tasks for this Canvas MCP server project:
+
+            1. **Dependency Analysis**
+               - Check pyproject.toml for outdated dependencies
+               - Verify canvasapi library compatibility with latest Canvas API
+               - Check if mcp library has updates
+               - Review Python version requirements
+
+            2. **Canvas API Compatibility**
+               - Review recent Canvas API changelog (if accessible via web search)
+               - Identify any deprecated endpoints we're using
+               - Check if new Canvas API features should be added
+
+            3. **Code Quality**
+               - Scan for TODO comments older than 30 days
+               - Check for unused imports or dead code
+               - Review error handling patterns
+
+            4. **Documentation Health**
+               - Verify README examples are still accurate
+               - Check if new tools need documentation
+               - Ensure CLAUDE.md instructions are current
+
+            5. **Issue Management**
+               - Review open issues older than 60 days
+               - Suggest closing stale issues or adding updates
+               - Identify issues that could be "good-first-issue"
+
+            6. **Security**
+               - Check for any hardcoded secrets or credentials
+               - Review environment variable usage
+               - Scan for common security anti-patterns
+
+            Create a detailed maintenance report as a GitHub issue with:
+            - Summary of findings
+            - Actionable recommendations
+            - Priority levels for each item
+            - Links to relevant files/lines
+
+            Use gh CLI to create the issue with label "maintenance".
+
+          claude_args: '--allowed-tools "Bash(gh:*),Read,Glob,Grep,WebSearch"'

canvas_mcp-1.0.0/.gitignore

@@ -0,0 +1,63 @@
+# Python files to ignore
+# Uncomment the following lines if you want to ignore specific Python files
+# some_specific_file.py
+# temp_*.py
+
+# Python virtual environment
+venv/
+fresh_venv/
+.venv/
+
+# Python cache files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Tool caches
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+
+# Environment variables
+.env
+
+# IDE specific files
+.vscode/
+.idea/
+*.swp
+*.swo
+.cursorrules
+
+# macOS specific files
+.DS_Store
+
+# Logs
+*.log
+
+# Documentation folder
+documents/
+
+# Development tools and files
+extract_canvas_api_docs.py
+canvas_api_docs/
+get_course_grades.py
+gradebook.json
+.env.template
+# Student data and utility scripts
+student_anonymization_mapping.txt
+show_student_mappings.py
+_**
+.aider*
+test_*.py
+
+# Local de-anonymization maps (contains PII)
+local_maps/
+docs/hybrid_builder_launch.md
+
+# Archive directory - old structure and development files
+archive/

canvas_mcp-1.0.0/Dockerfile

@@ -0,0 +1,38 @@
+# Use Python 3.12 slim image for smaller size
+FROM python:3.12-slim
+
+# Set working directory
+WORKDIR /app
+
+# Install uv package manager for faster dependency installation
+RUN pip install --no-cache-dir uv
+
+# Copy project files
+COPY pyproject.toml ./
+COPY LICENSE ./
+COPY README.md ./
+COPY env.template ./
+COPY src/ ./src/
+
+# Install dependencies using uv
+RUN uv pip install --system --no-cache -e .
+
+# Create non-root user for security
+RUN adduser --disabled-password --gecos '' mcp && \
+    chown -R mcp:mcp /app
+
+# Set environment variables (users must provide CANVAS_API_TOKEN and CANVAS_API_URL at runtime)
+# Example: docker run -e CANVAS_API_TOKEN=xyz -e CANVAS_API_URL=https://... canvas-mcp
+ENV MCP_SERVER_NAME="canvas-mcp" \
+    ENABLE_DATA_ANONYMIZATION="false" \
+    ANONYMIZATION_DEBUG="false"
+
+# Switch to non-root user
+USER mcp
+
+# Health check to verify installation
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+  CMD python -c "import canvas_mcp; print('OK')" || exit 1
+
+# Run the MCP server
+CMD ["canvas-mcp-server"]

canvas_mcp-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Vishal Sachdev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.