ClassQuill

ClassQuill MCP 服务

让任何支持 MCP 的 AI 工具——Claude、Codex、Cursor、Windsurf、Composio 等——读取你的 ClassQuill 辅导业务数据：课程、学生、导师、家长、发票、付款、课程计划、预约、收入和报告。

这是一个基于 ClassQuill public API（/v1）的轻量只读代理。每个工具都与一个公共 API 端点一一对应，因此工具列表始终与实际 API 保持一致。你的凭据不会离开你的设备（托管模式下则不会离开你的请求）。

ClassQuill 是 EquateIt 推出的辅导业务管理平台。npm 包以 equateit-mcp 发布。

两种使用方式

1. 托管模式（推荐——无需安装）

将任何远程 MCP 客户端连接到托管服务：

https://mcp.classquill.com/mcp

• Claude / Claude.ai——将其添加为自定义连接器并登录（OAuth）。
• Codex——codex mcp add classquill --url https://mcp.classquill.com/mcp
• 任何客户端——将你的 API 密钥作为 Bearer 令牌传入：Authorization: Bearer ei_live_…

2. 本地模式（通过 npx 自行运行）

npx -y equateit-mcp        # stdio, reads EQUATEIT_API_KEY

Claude Code：

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

Cursor / Claude Desktop / Windsurf（mcpServers 配置）：

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

获取 API 密钥

组织管理员可在 ClassQuill 应用的 Settings → Developers 中创建密钥。密钥格式为 ei_live_…，此服务仅具备读取权限。

工具

每个 /v1 GET 路由对应一个只读工具——课程、学生、导师、家长、发票、付款、课程计划、作业、问题、科目、文件、结果、可用时间、覆盖情况、报告等。工具列表由公共 OpenAPI 规范自动生成（npm run gen:tools），因此始终与实时 API 保持一致。

选项与环境变量

标志	环境变量	默认值	用途
--key	EQUATEIT_API_KEY	—	你的 ei_live_… 密钥（stdio 模式）。
--http	—	关闭	以 HTTP（Streamable HTTP）服务运行，而非 stdio。
--port / -p	MCP_PORT	3000	HTTP 端口。
—	EQUATEIT_API_BASE_URL	https://api.classquill.com	API 基础地址（末尾不带 /v1）。

在 HTTP 模式下，每个请求都通过 Authorization: Bearer … 提供自己的凭据——可以是 ei_live_… API 密钥，也可以是 OAuth 访问令牌。

开发

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

只需一个容器即可自托管 HTTP 服务——参见 Dockerfile。

许可证

MIT——参见 LICENSE。