bttf/ogremcp

Ogre MCP (Open Game Relay Engine): connect a video game to any AI agent through one remote MCP server. First kit: World of Warcraft Classic Era.

TypeScript

2

353 commits

updated Sep 26, 2026

See the code

See what people are saying

README

Ogre MCP

Ogre MCP (Open Game Relay Engine, ogremcp) connects a video game to any AI agent through one remote MCP server, so the agent can read your live game state and give spoiler-free guidance. The design is in docs/architecture.md.

Layout

PathContentsLicense
packages/sdk/@ogremcp/sdk: manifest schema, Interpreter interface, shared typesMIT
kits/wow/@ogremcp/kit-wow: WoW adapter, manifest, interpreter, fixturesMIT
platform/@ogremcp/platform: service, web UI, MCP server, bridge API, OAuth serverAGPL-3.0-or-later
bridge/Go module: the bridge that runs on the player's PCMIT

Self-host

To run your own server with Docker Compose, see docs/self-host.md.

License

Each of the four paths above has its own LICENSE file. platform/ is licensed under the GNU Affero General Public License v3.0 or later. packages/sdk/, kits/wow/, and bridge/ are licensed under the MIT License. Every file outside those four paths is licensed under the MIT License in the root LICENSE.

Contributing

Contributions use the Developer Certificate of Origin (DCO), not a CLA. Sign off every commit with git commit -s. CI fails a pull request if any of its commits lacks a Signed-off-by: line that matches the commit author's name and email.

ai-agents
claude
mcp
model-context-protocol
world-of-warcraft
wow-addon
wow-classic

Contributors

bttf

353 commits

bttf/ogremcp

Ogre MCP (Open Game Relay Engine): connect a video game to any AI agent through one remote MCP server. First kit: World of Warcraft Classic Era.

TypeScript

2

353 commits

updated Sep 26, 2026

See the code

See what people are saying

README

Ogre MCP

Ogre MCP (Open Game Relay Engine, ogremcp) connects a video game to any AI agent through one remote MCP server, so the agent can read your live game state and give spoiler-free guidance. The design is in docs/architecture.md.

Layout

PathContentsLicense
packages/sdk/@ogremcp/sdk: manifest schema, Interpreter interface, shared typesMIT
kits/wow/@ogremcp/kit-wow: WoW adapter, manifest, interpreter, fixturesMIT
platform/@ogremcp/platform: service, web UI, MCP server, bridge API, OAuth serverAGPL-3.0-or-later
bridge/Go module: the bridge that runs on the player's PCMIT

Self-host

To run your own server with Docker Compose, see docs/self-host.md.

License

Each of the four paths above has its own LICENSE file. platform/ is licensed under the GNU Affero General Public License v3.0 or later. packages/sdk/, kits/wow/, and bridge/ are licensed under the MIT License. Every file outside those four paths is licensed under the MIT License in the root LICENSE.

Contributing

Contributions use the Developer Certificate of Origin (DCO), not a CLA. Sign off every commit with git commit -s. CI fails a pull request if any of its commits lacks a Signed-off-by: line that matches the commit author's name and email.

ai-agents
claude
mcp
model-context-protocol
world-of-warcraft
wow-addon
wow-classic

Contributors

bttf

353 commits

Languages

TypeScript

64.8%

Go

22.3%

Lua

7.8%

PLpgSQL

1.9%

Shell

1.0%

JavaScript

1.0%