画布MCP用于Poke
自定义MCP服务器，使用Canvas LMS API为Poke提供成绩、截止日期、作业等上下文
是什么 戳？-我每天使用的人工智能助手，通过在imemessage上发短信来管理日常任务、电子邮件、待办事项列表等
概述
- 认证：Canvas个人访问令牌，API密钥（承载令牌）
- 数据访问：只读，Canvas学生帐户
此MCP可以帮助回答Poke的问题
- 我即将到来的最后期限是什么？
- 最近发布了哪些公告？
- 我即将到来的一周是什么样子的？
- 我今天的学术日是什么样子的？
- 我的作业最近评分了吗？
设置Canvas访问令牌
- 登录您的canvas帐户
- 转到您的帐户，设置页面
- 滚动到已批准的集成
- 创建新的访问令牌（复制令牌，因为您不会再看到它）
快速开始
git clone https://github.com/Shashwatpog/poke-canvas-mcp
cd poke-canvas-mcp
# Create a virtual environment and install required packages
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# Edit .env with your Canvas credentials and POKE_API_KEY (use a strong key)
# Run
python src/server.py
# In a different terminal run the inspector for testing
npx @modelcontextprotocol/inspector服务器在上运行http://localhost:8000/mcp，使用“流式HTTP”传输进行连接
环境变量
CANVAS_BASE_URL=https://your_school.instructure.com
CANVAS_ACCESS_TOKEN=you_canvas_access_token
POKE_API_KEY=your_api_key部署
这 render.yaml 文件包含要在渲染上部署的配置
- 分叉此存储库
- 在渲染时创建新的web服务
- 连接您的分叉存储库
- 输入环境变量并展开（CANVAS_BASE_URL、CANVAS_ACCESS_TOKEN、POKE_API_KEY）
Poke集成
部署MCP后，在poke设置中添加MCP URL poke.com/设置/连接
还要添加您的API密钥，以便Poke可以向MCP服务器进行身份验证（标头：x-API-key或授权：Bearer）。 使用强密钥（32+随机字符）或在将其添加到渲染和戳之前生成一个强密钥。
为了测试一下，问poke“我今天需要在画布上做什么？”“我即将在画布上完成的最后期限是什么？”
或者，您可以通过提及MCP的连接名称并要求它直接调用其中一个工具来明确要求poke使用MCP。
示例：“使用Canvas MCP连接的get_today_summary工具”
功能和MCP工具
1.get_today_summary
- 此工具专为每日签到和通知而设计。
- 用于在24至48小时的窗口内创建截止日期、公告、成绩通知列表，以及过去一周的任何逾期作业。
2.get_upcoming_assignments
- 该工具汇总当前课程的作业，包括即将到来的截止日期、逾期项目，并首先对最紧急的项目进行排序。
3.获取新闻公告
- 此工具返回所有最近的公告，并提供各种选项：限制课程数量、查找期间每门课程的公告数量。
- 还可以选择获取完整的消息正文，以防用户想要完整公告消息的摘要。
4.获取最近的评分
- 此工具检测作业何时进行新评分，并使用画布规划器提要。用于在测验和作业的成绩公布时通知用户。
5.向前看
- 此工具返回即将到来的任务、截止日期、公告、下周的日历事件，以帮助用户更好地规划他们的一周。
6.列表_索赔_法律
- 此工具返回所有活动课程的列表。
7.get_dashboard_cards
- 此工具按用户设置的顺序返回仪表板上当前所有课程的列表。用于轻松过滤课程。
8.任务分配
- 此工具返回特定课程的所有即将完成的作业，并可选择使用课程id包含逾期作业。
我面临的问题
管理个人电子邮件、学校电子邮件、工作电子邮件、画布通知和待办事项列表非常困难和耗时。
我经常发现自己试图跟上画布上的通知和截止日期，但在学期中期课程加快的时候却记不住了。
Poke作为一名助手非常擅长跟踪我的电子邮件，但每次我必须跟踪画布的截止日期，我都必须手动拍摄画布日历的屏幕截图，并输入图像来戳或要求它手动创建事件。
这个痛点的解决方案是Canvas MCP集成！
MCP的工作原理
我能够浏览Canvas LMS API文档（这既困难又令人困惑），同时在“网络”选项卡中手动浏览，以找到我们可以访问的各种API端点，从而获取学生和课程数据。
MCP聚合并规范化多个端点：
| 端点 | 描述 |
|---|---|
| GET/api/v1/dashboard/dashboard_cards | 按仪表板顺序获取活动课程 |
| GET/api/v1/course/：course_id/作业？include\[\]=提交 | 使用提交元数据获取作业 |
| GET/api/v1/course/：course_id/discussion_tames？only _ announcements=true | 获取课程公告 |
| GET/api/v1/planner/items | 活动、作业、测验和成绩的计划提要 |
| GET/api/v1/courses | 获取所有已注册的课程 |
挑战
我遇到的一些挑战肯定包括找到正确的API端点作为 Canvas LMS文档 下面列出了一系列不同的API。特别是考虑到其中列出的API端点中有一半只能使用管理员访问权限或开发人员密钥访问，因此很难确定将使用哪些API。
像我这样的学生没有这种授权，也无法生成开发人员密钥。然而，学生可以生成访问令牌，我们已将其用于此MCP。
因此，在使用之前，我必须手动命中每个API端点，以确保我可以访问它们。
由于json格式的响应中还包含了许多不必要的元数据和细节，我决定浏览这些响应，找出要保留哪些项目，并将其作为上下文提供。例如，在获取课程时，我决定只返回mcp工具中的课程id和名称。
我面临的另一个挑战是Canvas让我上学期的旧课程保持活跃和注册。唯一的解决办法是为每个学期使用前缀，例如“26FS”表示2026年秋季学期课程，“26SS”表示2026年春季学期课程。
此外，我还必须将各种字段（如“due_at”、“graded_at”等）中的时间戳标准化为UTC，以使其一致且易于过滤截止日期。
喊出来 例如ai：让我在Canvas api文档中失去理智后，很容易搜索Canvas的api端点！
未来的目标
- 到目前为止还没有计划，将测试几周，如果我有任何问题，将添加更多工具/更新当前工具