Classquill Mcp

io.github.EquateItAu由 GitHub 帳號 EquateItAu 發布v1.0.1更新於 Nov 2, 2026

Read-only MCP server for ClassQuill, a tutoring-business-management platform.

已驗證Streamable HTTP可網頁執行金融商業與電商

概覽

AI 產生的概覽

ClassQuill（家教業務管理平台）的唯讀 MCP 伺服器，讓助理存取課程、學生、發票、付款與報表等資料。

可以做什麼
  • 讀取課程、預約與可預約時段
  • 讀取學生、導師與家長資料
  • 讀取發票、付款與收入
  • 讀取教案、作業、題目與科目
  • 讀取檔案、成績、涵蓋情況與報表
  • 每個工具對應一個公開 API 的 GET 端點，由 OpenAPI 規格產生
適用情境
適合以 ClassQuill 管理家教業務的使用者，讓助理在對話中查詢排課、學生或導師紀錄、帳務與付款狀態以及報表資料。它為唯讀，適合提問與彙整，不適合修改資料。
執行需求
可使用託管的遠端端點並以 OAuth 登入，或在本地以 npx 執行 npm 套件（需 Node.js）。需要由組織管理員在應用程式設定中的開發人員頁面建立的 ClassQuill API 金鑰（EQUATEIT_API_KEY）；HTTP 模式下每個請求自帶 Bearer 權杖。需能連線至 ClassQuill API。
安裝前請注意
需要 ClassQuill API 金鑰或 OAuth 登入，可存取學生、家長、發票與付款等業務及客戶資料。伺服器標示為唯讀，但金鑰仍應視為機密，避免寫入共用設定。託管模式下請求與憑證會傳送至廠商端點。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Classquill Mcp，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.EquateItAu%2Fclassquill-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "classquill": {
      "type": "http",
      "url": "https://mcp.classquill.com/mcp"
    }
  }
}

README

ClassQuill MCP server

[smithery badge]

Give any MCP-aware AI tool — Claude, Codex, Cursor, Windsurf, Composio, and more — read access to your ClassQuill tutoring-business data: sessions, students, tutors, parents, invoices, payments, lesson plans, bookings, earnings, and reports.

It's a thin, read-only proxy over the ClassQuill public API (/v1). Each tool maps 1:1 to a public API endpoint, so the tool list can never drift from the real API. Your credentials never leave your machine (or, in hosted mode, your request).

ClassQuill is the tutoring-business-management platform by EquateIt. The npm package is published as equateit-mcp.

Two ways to use it

1. Hosted (recommended — nothing to install)

Point any remote-MCP client at the hosted server:

https://mcp.classquill.com/mcp
  • Claude / Claude.ai — add it as a custom connector and sign in (OAuth).
  • Codex — codex mcp add classquill --url https://mcp.classquill.com/mcp
  • Any client — pass your API key as a Bearer token: Authorization: Bearer ei_live_…

2. Local (run it yourself via npx)

bash
npx -y equateit-mcp        # stdio, reads EQUATEIT_API_KEY

Claude Code:

bash
claude mcp add classquill -e EQUATEIT_API_KEY=ei_live_xxxx -- npx -y equateit-mcp

Cursor / Claude Desktop / Windsurf (mcpServers config):

json
{  "mcpServers": {    "classquill": {      "command": "npx",      "args": ["-y", "equateit-mcp"],      "env": { "EQUATEIT_API_KEY": "ei_live_xxxx" }    }  }}

Getting an API key

Create one in the ClassQuill app under Settings → Developers (org admins). Keys look like ei_live_… and are read-only for this server.

Tools

One read-only tool per /v1 GET route — sessions, students, tutors, parents, invoices, payments, lesson-plans, homework, questions, subjects, files, results, availabilities, coverage, reports, and more. The list is generated from the public OpenAPI spec (npm run gen:tools) so it always matches the live API.

Options & environment

FlagEnv varDefaultPurpose
--keyEQUATEIT_API_KEY—Your ei_live_… key (stdio mode).
--http—offRun as an HTTP (Streamable HTTP) server instead of stdio.
--port / -pMCP_PORT3000HTTP port.
—EQUATEIT_API_BASE_URLhttps://api.classquill.comAPI base (no trailing /v1).

In HTTP mode, each request supplies its own credential as Authorization: Bearer … — an ei_live_… API key or an OAuth access token.

Develop

bash
npm installnpm run build     # → dist/npm test          # unit tests (url builder + auth scheme)

Self-hosting the HTTP server is a single container — see Dockerfile.

License

MIT — see LICENSE.

來源：README.md，提交 68dfb7d

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分