Piazza MCP 服务器 (Piazza MCP Server)

这是一个基于模型上下文协议 (Model Context Protocol, MCP) 的服务器，它使用非官方的 piazza-api Python 库与 Piazza 进行集成。该服务器允许 AI 助手（如 Claude、Cursor 和 VS Code 扩展）安全地访问你的 Piazza 课程数据并进行交互。

功能特性

该服务器向 AI 助手暴露了以下 MCP 工具：

  • get_user_profile(): 获取当前 Piazza 用户的个人资料信息。
  • get_user_classes(): 获取当前用户加入的所有课程及其课程网络 ID。
  • get_post(network_id, post_id): 通过帖子 ID (CID) 检索指定课程网络 (network_id) 中的特定帖子，并自动将其内容（包含老师和学生的答案、跟进讨论）整理总结为结构化并且脱去庞杂 HTML 标签的整洁 Markdown。
  • read_attachment(url): 利用服务器当前的认证会话直接抓取帖子中的链接地址，自动下载提取课件文件 (PDF, PPTX, DOCX, TXT) 内的结构化正文文本，方便直接审阅。
  • search_posts(network_id, query): 使用文本查询在指定课程网络 (network_id) 中搜索帖子。
  • get_users(network_id, user_ids): 通过用户 ID 查找指定课程网络 (network_id) 中的用户资料。
  • get_all_users(network_id): 检索指定课程网络 (network_id) 中的所有用户/花名册列表。

配置与使用

服务器需要以下环境变量来与 Piazza 进行身份验证：

  • PIAZZA_EMAIL: 你的 Piazza 登录邮箱。
  • PIAZZA_PASSWORD: 你的 Piazza 登录密码。

为 MCP 客户端进行配置 (如 Claude Desktop)

要将此服务器用于支持 MCP 的客户端（例如 Claude Desktop），你可以使用 uvx 直接从项目目录运行：

{
  "mcpServers": {
    "piazza-mcp": {
      "command": "uvx",
      "args": [
        "piazza-mcp-server"
      ],
      "env": {
        "PIAZZA_EMAIL": "your_email@example.com",
        "PIAZZA_PASSWORD": "your_password"
      }
    }
  }
}

免责声明

这是一个非官方的集成项目。它不是由 Piazza Technologies Inc. 提供、支持或以任何方式建立附属关系的。请自行承担使用风险。

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Ergo042 from gravatar.com Ergo042

Credits

Author: Neikos

License expression

MIT
View SPDX License List

Requires

Python >=3.12

Tags

agent ai claude mcp piazza

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

piazza_mcp_server-0.1.2.tar.gz (60.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

piazza_mcp_server-0.1.2-py3-none-any.whl (7.1 kB view details)

Uploaded Python 3

File details

Details for the file piazza_mcp_server-0.1.2.tar.gz.

File metadata

  • Download URL: piazza_mcp_server-0.1.2.tar.gz
  • Upload date:
  • Size: 60.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for piazza_mcp_server-0.1.2.tar.gz
Algorithm Hash digest
SHA256 c125b2a608cabc5921c614311c10766f0e37e71af8c1facc48237cb25a696e29
MD5 314da25644c00103e3874a54d35ddf2e
BLAKE2b-256 798e7980b8b2dfb18a533c151c02b5b659cd13f17a0528150a8cf05af5420c23

See more details on using hashes here.

Provenance

The following attestation bundles were made for piazza_mcp_server-0.1.2.tar.gz:

Publisher: publish.yml on Ergo042/piazza-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file piazza_mcp_server-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for piazza_mcp_server-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 45ef399c526796704f062a4be33235e32a4c712637f6350d40ffe218a2bd8020
MD5 b8320e94ca6cc87ac9285ce5867f3012
BLAKE2b-256 ca7cb4053eab965940fd4aff67b6e6d80993b9fbf057c0f1853c055e02768be1

See more details on using hashes here.

Provenance

The following attestation bundles were made for piazza_mcp_server-0.1.2-py3-none-any.whl:

Publisher: publish.yml on Ergo042/piazza-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 files

0.1.1

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page