Skip to content
Back to search

wow-mcp

A levelling log for World of Warcraft: Forever, with an MCP server so your own AI assistant can read it.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/sam-dumont/wow-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/sam-dumont/wow-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sam-dumont--wow-mcp/badge.svg)](/listings/sam-dumont--wow-mcp)

HTML

<a href="/listings/sam-dumont--wow-mcp"><img src="/api/listings/sam-dumont--wow-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 107 lines
  1. # wow-stats
  2. A levelling log for World of Warcraft: Forever, with an MCP server so your own AI assistant
  3. can read it.
  4. A small program on the computer you play on reads what the game and your addons already save.
  5. A server you run turns it into your climb: time per level against Polestar's route, where the
  6. hours went, the next upgrade per slot and where it drops, the dungeons worth running, deaths,
  7. one journal entry per play session, a plan for your next two hours. Claude, ChatGPT or any
  8. MCP client can ask about it, and the server re-runs the SQL behind every number your assistant
  9. wants to keep.
  10. It runs on your computer or a small box at home. Nothing goes anywhere else unless you set it
  11. up that way. (Yes, it's absolutely overkill for levelling stats: a hardened image, signed
  12. releases, OIDC, and a 3D viewer that reads the game's own files. The character page still
  13. answers in 31 ms on the demo.)
  14. It's a hobby project: GPL-3.0, no warranty, no support promise, and security fixes land when
  15. I can make them. If you use a friend's server, you trust that friend: they hold your data,
  16. and the install command comes from their server.
  17. ![The Overview of the demo character Nibbet, level 34: behind the route at 2.2 times Polestar's route time, the next level in 2h 24m of play, 91% of guide steps in order, his next moves, and time per level against the route](docs/images/overview.webp)
  18. **[Live demo](https://sam-dumont.github.io/wow-mcp/demo/)**: Nibbet-Gearholt, an invented Gnome
  19. priest, no install.
  20. ## Three ways in
  21. 1. **[Join a friend's server](docs/players/getting-started.md)**: someone runs it for you and
  22. sent you a link. Nothing from this repository needed.
  23. 2. **[Try the demo](docs/self-host/demo.md)**: Docker and five made-up characters on your
  24. computer, about 10 minutes, no game needed.
  25. 3. **[Track my character](docs/install.md)**: run the server, add the addons and the small
  26. program on the computer you play on.
  27. Then, for your AI: **[Connect your AI](docs/ai/connect.md)**. Everything else is in
  28. **[the manual](docs/README.md)**, also on the [docs site](https://sam-dumont.github.io/wow-mcp/).
  29. ## The demo in two commands
  30. With [Docker](https://docs.docker.com/get-docker/) running and logged in to Docker's hardened
  31. images once (`docker login dhi.io`, a free Docker Hub account), from the top of a copy of
  32. this repository (Mac, Linux, or Git Bash on Windows):
  33. ```sh
  34. cd deploy/compose && export INGEST_PASSWORD=demo-password-only
  35. docker compose up -d --build ui && docker compose exec -T ui python - --vl http://victorialogs:9428 < ../../dev/seed.py
  36. ```
  37. The first run builds the image, a minute or two. It ends with
  38. `1831 events into http://victorialogs:9428`. Open <http://127.0.0.1:8080/>: five made-up
  39. characters, each with a DEMO DATA banner. `docker compose down -v` removes it all.
  40. PowerShell, a port already taken, or the sites for friends: [Try the demo](docs/self-host/demo.md).
  41. ## How it fits together
  42. ```
  43. the PC you play on your server (docker compose)
  44. the shipper ---POST over HTTPS---> ui :8080 ---> VictoriaLogs (your events, kept)
  45. every 5 min, reads WTF/ and Logs/ | your page (the full view, behind your login)
  46. | /mcp for your AI assistant
  47. +-- publish + site :8081: static copies for friends
  48. +-- optional: exporter ---> VictoriaMetrics
  49. (Battle.net data, 23 days)
  50. ```
  51. - **Your data stays yours.** Your page shows everything, behind your login. Friends get a
  52. sealed copy with a key in the link; anyone gets a public copy cut to an allow list. Neither
  53. ever shows other players, what killed you, or where you are now.
  54. [Privacy tiers](docs/explanation/privacy.md).
  55. - **No model on the server.** Your assistant does the thinking, in your own account; the
  56. server hands it data and checks its numbers. [Ask about your character](docs/ai/asking.md).
  57. - **Known addons only.** It reads [Polestar](https://github.com/fitzforge/polestar) and other
  58. well-known addons; it never asks you to install one of its own. [Addons](docs/reference/addons.md).
  59. - **Small.** One player fits in 2 vCPU and 2 GiB of RAM; a year of events takes a few MiB.
  60. [Sizing](docs/self-host/sizing.md).
  61. ## The manual
  62. | You are | Start here |
  63. |---|---|
  64. | A player a friend invited | [Join a friend's server](docs/players/getting-started.md), then [your page at a glance](docs/players/your-page.md) and [something's wrong](docs/players/troubleshooting.md) |
  65. | Running your own server | [Try the demo](docs/self-host/demo.md), [install it](docs/install.md), then [run it on a server](docs/self-host/production.md) |
  66. | Using an AI assistant | [Connect your AI](docs/ai/connect.md), [ask about your character](docs/ai/asking.md), [every tool](docs/reference/mcp-tools.md) |
  67. | Contributing | [Development](docs/development.md), [architecture](docs/architecture.md), [CONTRIBUTING.md](CONTRIBUTING.md), [SECURITY.md](SECURITY.md), [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) |
  68. What changed in each version: [CHANGELOG.md](CHANGELOG.md).
  69. ## License
  70. GPL-3.0-only ([LICENSE](LICENSE)). The kit ships route times and gear data
  71. made from [Polestar](https://github.com/fitzforge/polestar) (GPL-3.0-only) and
  72. its quest database forever-db (GPL-3.0), so it is GPL too. Thanks to
  73. fitzforge and Polestar's contributors: the route clock and the gear scoring
  74. are theirs. The gear data carries parts under MIT, from ForeverLevelingBiS
  75. v0.12.0-beta by Thunder and from wowsims: their notices are in
  76. [THIRD_PARTY.md](THIRD_PARTY.md).
  77. The images (`/app/LICENSE`) and the installed shipper (`LICENSE` next to it)
  78. carry the license and the source they were built from.
  79. The page's fonts (Cinzel, Alegreya, Alegreya Sans) are under the SIL Open
  80. Font License, their license files in `web/fonts/`.
  81. World of Warcraft is a trademark of Blizzard Entertainment. Item names,
  82. icons and models the server fetches stay Blizzard's: this kit doesn't
  83. bundle them.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.