1 v0.1.0 更新于 2026-10-16

mcp-piazza MCP Server

Read-only Piazza access: activity, search, unread posts, full threads, and course info

适用客户端

本地客户端
Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端

安装配置

本地运行(pypi)
{
  "mcpServers": {
    "mcp-piazza": {
      "command": "uvx",
      "args": [
        "mcp-piazza"
      ]
    }
  }
}

将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。

提供的工具 接入后 Agent 可调用这 12 个工具

list_courses
列出你的课程及其 ID、课程号、学期、角色、活跃状态和文件夹。
get_course_info
获取课程页面信息:描述、大纲、办公时间、通用信息和授课人员邮箱。
get_unread_counts
统计各活跃课程中的未读帖子数量。
recent_activity
列出指定时间以来有新动态的帖子,可查询全部或单个课程。
list_posts
列出帖子摘要,支持未读、未解决、我发布的、收藏等多种过滤和分页。
search_posts
按关键词在单个课程或所有活跃课程中搜索帖子。
get_post
读取一个完整帖子线程,包括问题、师生回答、追问和投票数据。
get_posts
一次调用读取最多 20 个完整帖子线程。
get_post_history
显示帖子的每个历史版本,并展示版本间差异。
list_instructor_notes
列出教师发布的笔记和投票。
get_attachment
打开帖子中的图片或文件附件,模型可以查看图片。
get_course_stats
获取课程统计页面的数据。