Easy English Tool 英语学习速通工具

Easy English Tool (英语进阶营)

This skill gives you access to the user's personal English learning data and actions. The backend is an Express server serving both REST APIs and MCP endpoints on the same port — no separate MCP process needed.

Quick check: is MCP configured?

Before using this skill, check your available tools. If you see any tool named account_login, get_profile, get_today, vocab_add, etc. — the MCP server is configured. Jump to Path A. If none of these tools exist, use Path B (REST fallback).

---

Path A: MCP is configured (preferred)

The MCP server is named easy-english-tool and exposes 22 tools on https://english.geeyo.com. The MCP endpoints are served in-process by the Express backend — no separate MCP process needed.

Authentication flow

1. The user sets a username/password on the web "My" page (POST /api/users/bind).
2. Call account_login with those credentials. The MCP session caches userId, and all subsequent tools automatically use it.
3. If the user has no account yet, guide them to the web page first, then come back.

Tool reference

Account

Profile & Learning

Vocabulary

Articles

Study Actions

Media

---

Path B: MCP is NOT configured (REST fallback)

If the MCP server is not registered in your agent config, call the REST API directly at https://english.geeyo.com.

Configuring MCP (recommended)

To add the MCP server permanently, add this to your agent's MCP config:

{
  "mcpServers": {
    "easy-english-tool": {
      "type": "streamableHttp",
      "url": "https://english.geeyo.com/api/mcp/http"
    }
  }
}

Or for SSE-based clients:

{
  "mcpServers": {
    "easy-english-tool": {
      "type": "sse",
      "url": "https://english.geeyo.com/api/mcp/sse"
    }
  }
}

After adding, restart the agent and return to Path A.

REST API fallback mapping

All endpoints share the same base: https://english.geeyo.com. Anonymous auth: include header x-user-id: . Get a userId by calling POST /api/users/ensure.

Server lifecycle

• Production: https://english.geeyo.com
• Local dev: cd C:\projects\Node.js\H5\server && npm run dev (listens on :3001)
• Health check: GET https://english.geeyo.com/api/health → {"ok":true}
• Zero extra deps: MCP runs in-process with Express, no @modelcontextprotocol/sdk needed.

Common workflows

First-time setup for a user:

1. Call POST /api/users/ensure with x-user-id: → get userId
2. Call POST /api/diagnose → ensure user record
3. Call GET /api/levels → pick a level
4. Call POST /api/level {level} → set level
5. Optionally call POST /api/users/bind {username, password} → bind account for cross-device

Daily study session:

1. GET /api/today → get today's article
2. GET /api/vocab → review vocabulary
3. POST /api/tts → listen to article
4. POST /api/copy {action:"submit"} or {action:"load"} → practice writing
5. POST /api/quiz → submit quiz
6. GET /api/checkin/poster → generate sharing poster
7. GET /api/profile → check updated stats