L2 Calendar

l2calendar-mcp

L2 Calendar 用の MCP サーバーです。Claude Desktop、Cursor、VS Code、Windsurf、Cline など、あらゆる MCP クライアントから、クロニクル別に今後オープンする Lineage 2 のプライベートサーバーを検索できます。

無料で公開されている CORS 対応の L2 Calendar API をラップし、MCP ツールとして公開します。

ツール

ツール	機能
list_servers	追跡対象のサーバーを、VIP ステータスとオープン日の順に一覧表示します。フィルター：chronicle、only_upcoming、new_only、min_rate、max_rate、limit。
get_chronicles	フィルターに使用できるすべてのクロニクル（スラッグと表示名）を一覧表示します。
search_servers	名前、ウェブサイト、レート、クロニクル、説明、ラベルを対象に全文検索します。
get_server	正確な名前を指定して、1 つのサーバーの公開情報全体を取得します（大文字と小文字は区別しません）。
list_labels	使用中の異なるラベル（PTS、低レート、クラフトなど）を色とともに一覧表示します。

すべての結果は JSON 形式で、モデルが推論に利用できます。

データソース

すべてのデータは公開 API から取得します。

• GET https://l2calendar.com/api/servers — 1 回の呼び出しで最大 50 件のサーバーを取得します。?chronicle=<slug> フィルターを任意で指定できます。
• GET https://l2calendar.com/api/chronicles — クロニクルの一覧。

API は読み取り専用で、キーは不要です。また、Access-Control-Allow-Origin: * を返します。

サーバーごとに返されるフィールド：name、website_url、rate、opening_date、opening_time、opening_datetime_utc、description、is_vip、vip_level、multiproff、multicraft、is_new、chronicle、labels。

注記： 公開 API が返すのは、最大 50 件のサーバーを含む 1 ページのみです（VIP 優先、次にオープン日が近い順）。フィルターや検索を行うツールは、この公開ページを対象とします。chronicle フィルターを使うと、より正確に絞り込めます。

インストール

リモート（HTTP）— インストール不要

ホストされている場合は、ストリーミング可能な HTTP エンドポイントをクライアントに指定します。

{
  "mcpServers": {
    "l2calendar": {
      "type": "http",
      "url": "https://<your-host>/mcp"
    }
  }
}

ローカル（stdio）、npx 経由

{
  "mcpServers": {
    "l2calendar": {
      "command": "npx",
      "args": ["-y", "l2calendar-mcp"]
    }
  }
}

ローカル（stdio）、ソースから

git clone https://github.com/Dreiev/l2calendar-mcp.git
cd l2calendar-mcp
npm install
npm run build

{
  "mcpServers": {
    "l2calendar": {
      "command": "node",
      "args": ["/absolute/path/to/l2calendar-mcp/dist/index.js"]
    }
  }
}

HTTP トランスポートの実行

node dist/index.js --http            # http://127.0.0.1:8787/mcp
node dist/index.js --http --port 9000

GET /health は、稼働状況の確認用に { "status": "ok" } を返します。

設定

変数	デフォルト	用途
L2CALENDAR_API_URL	https://l2calendar.com	クエリ対象となる L2 Calendar インスタンスのベース URL。

プロンプトの例

• 「近日オープンする Interlude サーバーを一覧表示してください。」
• 「今週、新たにオープンする Classic サーバーはどれですか？」
• 「レートが x1000 の High Five サーバーを検索してください。」
• 「L2 Calendar が追跡しているすべてのクロニクルを表示してください。」
• 「L2Hispano という名前のサーバーの詳細を取得してください。」

開発

npm install
npm run build      # tsc -> dist/
npm run dev        # run src/index.ts directly (Node >= 22)
npm run start:http # build output over HTTP

L2 Calendar について

L2 Calendar は、クロニクル別に Lineage 2 のプライベートサーバーのオープン情報を追跡する多言語（EN/ES/PT/RU）カレンダーです — l2calendar.com。

ライセンス

MIT © Dreiev