leekwars-mcp

Standard TypeScript MCP server scaffold.

Structure

• src/index.ts - entrypoint

• src/auth/ - MCP-owned LeekWars session handling

• src/server/ - server bootstrap and request routing

• src/tools/ - manifest-driven tool definitions and registry

• src/tools/{core,auth,leek,fight,ai,items,reports}/ - tool manifests grouped by domain

• src/resources/ - resource definitions

• src/prompts/ - prompt definitions

• src/config/ - runtime config

• src/common/ - shared types/helpers

• src/scripts/ - subprocess bridge for vendored LeekWars scripts

• src/tools/_shared/ - vendored script helpers and shared assets

Related MCP server: CTFd MCP Server

Auth

The server now owns the LeekWars session.

Required env vars:

• LEEKWARS_LOGIN

• LEEKWARS_PASSWORD

Optional env vars:

• LEEKWARS_AUTH_RETRY_DELAY_MS

• LEEKWARS_API_BASE_URL

• LEEKWARS_SCRIPTS_DIR (defaults to src/tools)

• LEEKWARS_SOCKET_URL

• LEEKWARS_SOCKET_PROTOCOLS (comma-separated)

• LEEKWARS_SOCKET_CONNECT_TIMEOUT_MS

• LEEKWARS_SOCKET_REQUEST_TIMEOUT_MS

• LEEKWARS_SOCKET_MAX_BUFFERED_EVENTS

• MCP_SERVER_NAME

Tool registry

Tools are manifest-driven from src/tools/manifest.ts and executed through src/tools/registry.ts.

Tool output kinds:

• json - stdout only

• markdown - stdout only

• text - stdout + stderr formatting

Testing

• npm test - smoke tests for manifest loading, output formatting, and representative tool execution

• npm run check - typecheck only

• npm run build - compile to dist/

Scripts

• npm run dev - run in watch mode

• npm run start - run compiled server

Fight logs

fetch_fight_logs uses Playwright. If the browser binary is missing, install it with:

npx playwright install chromium

Socket bridge

The socket bridge connects to wss://leekwars.com/ws by default (override with LEEKWARS_SOCKET_URL) and uses the LeekWars session auth headers. It exposes bridge tools:

• socket_connect

• socket_status

• socket_send

• socket_call

• socket_recv

• socket_close

Encyclopedia tools

Encyclopedia search and page retrieval live in the separate leekwars-mcp-encyclopedia server. Configure both MCP servers if you need both game actions and encyclopedia knowledge tools.