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 分