convez.ai
MCP ServerIntegração & APIsIntermediário
admin978

Canvas MCP Server

admin978/canvas-mcp

Acesse Canvas LMS localmente via MCP, sem intermediários na rede

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP local-first para Canvas LMS que expõe a API Canvas como ferramentas MCP. Permite que alunos acessem cursos, tarefas, notas e conteúdo do Canvas via Claude ou outros clientes MCP, sem dependência de terceiros. Implementado em Python puro com transporte stdio.

Instalação

$npx convez-ai admin978/canvas-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
v0.1.3
Issues abertas
0
Contribuidores
2

Casos de uso

  • Consultar notas, tarefas e prazos de múltiplos cursos simultaneamente
  • Buscar conteúdo e anúncios do Canvas de forma consolidada
  • Baixar em lote arquivos de cursos para indexação offline
  • Integrar dados acadêmicos do Canvas com fluxos de automação Claude

Veredito

Solução prática para estudantes e educadores que usam Canvas. Código limpo e auditável (~125 linhas), mas ainda em alfa e requer token de acesso Canvas. Preenche bem a lacuna de acesso programático ao LMS sem intermediários de rede.

README

A tradução para o português deste README ainda está na fila.

canvas-mcp

Local-first MCP server for Canvas LMS. Stdio transport, no network round-trips beyond the official Canvas API.

Status: alpha. Single-user, no warranty, API surface may still shift. File issues if it breaks.

Why

Canvas is built for instructors. As a student you get a fragmented UI, no cross-course search, and notifications that arrive late or never. This server exposes the Canvas REST API as MCP tools so you can drive the LMS from any MCP-compatible client (Claude Code, Claude Desktop, etc.).

Architecture

[client] ──stdio──> [server.py] ──https──> [Canvas API]
  • Token lives in ~/.canvas.env (chmod 600)
  • Server runs locally, no third party in the path
  • Single file, fully auditable

Tools exposed

list_courses, list_assignments, list_modules, list_announcements, get_page, get_file_info, get_grades, planner_items, upcoming_events, todo.

Setup

1. Mint a Canvas personal access token

In Canvas: Account → Settings → Approved Integrations → + New Access Token. Copy the token shown — it is not retrievable afterwards.

2. Install

From PyPI (recommended):

pip install canvas-local-mcp

Or from source:

git clone https://github.com/admin978/canvas-mcp.git && cd canvas-mcp
python3 -m venv .venv && source .venv/bin/activate
pip install -e .

Then create the env file:

curl -fsSL https://raw.githubusercontent.com/admin978/canvas-mcp/main/.canvas.env.example -o ~/.canvas.env
chmod 600 ~/.canvas.env
# edit ~/.canvas.env: set CANVAS_BASE_URL (institution root, no /api/v1)
# and paste the token into CANVAS_TOKEN

3. Register with your MCP client

Claude Code:

claude mcp add canvas-local -- canvas-local-mcp

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "canvas-local": {
      "command": "canvas-local-mcp"
    }
  }
}

Bulk dump

canvas-local-mcp-dump downloads every file the user has access to (course materials, syllabi). Useful for offline indexing.

canvas-local-mcp-dump              # all active courses
canvas-local-mcp-dump 12345 67890  # specific course IDs

Output goes to ./canvas-dump/ by default. Override with CANVAS_DUMP_DIR=/path/to/dir.

License

MIT — see LICENSE.


Built by AGENTE 404 S.L. · admin@agente404.com

Ver o original no GitHub

Bom para

Relacionados