l2calendar-mcp
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
MCP server for L2 Calendar — query upcoming **Lineage 2 private server openings** by chronicle directly from any MCP client (Claude Desktop, Cursor, VS Code, Windsurf, Cline...).
It wraps the free, public, CORS-enabled L2 Calendar API and exposes it as MCP tools.
Tools
| Tool | What it does |
|------|--------------|
| list_servers | List tracked servers, ordered by VIP status + opening date. Filters: chronicle, only_upcoming, new_only, min_rate, max_rate, limit. |
| get_chronicles | List every chronicle (slug + display name) to use as a filter. |
| search_servers | Free-text search across name, website, rate, chronicle, description and labels. |
| get_server | Full public record of one server by exact name (case-insensitive). |
| list_labels | Distinct labels in use (PTS, Low rate, Craft...) with colors. |
Every result is JSON, ready for the model to reason about.
Data source
All data comes from the public API:
- GET https://l2calendar.com/api/servers — up to 50 servers per call, optional ?chronicle= filter.
- GET https://l2calendar.com/api/chronicles — the chronicle catalog.
The API is read-only, requires no key and sends Access-Control-Allow-Origin: *.
Fields returned per server: name, website_url, rate, opening_date, opening_time, opening_datetime_utc, description, is_vip, vip_level, multiproff, multicraft, is_new, chronicle and labels.
> **Note:** the public API returns a single page of up to 50 servers (VIP first, then soonest opening). Tools that filter or search operate on that public page. Increase precision with the chronicle filter.
Install
Remote (HTTP) — no install
When hosted, point your client at the streamable HTTP endpoint:
Local (stdio) via npx
Local (stdio) from source
Run the HTTP transport
GET /health returns { "status": "ok" } for uptime checks.
Configuration
| Variable | Default | Purpose |
|----------|---------|---------|
| L2CALENDAR_API_URL | https://l2calendar.com | Base URL of the L2 Calendar instance to query. |
Example prompts
- "List the Interlude servers opening soon."
- "Which Classic servers are new this week?"