# liblua with MCP

> An MCP-aware Lua runtime for applications that embed Lua.

Canonical URL: https://liblua-with-mcp.buanzo.org/

Project repository: https://github.com/buanzo/lua-mcp

## Summary

liblua-mcp experiments with putting a local MCP server surface inside liblua
itself. Applications that already embed Lua can compile against liblua-mcp and
gain a runtime-owned local MCP endpoint without each host application
implementing MCP directly.

The primary adoption model is intentional compilation against liblua-mcp.
ABI-compatible replacement or relinking can be useful in lab proofs, but it is
not the project headline.

## Safety model

- observe: default, read-oriented runtime inspection.
- control: explicit opt-in for registered semantic host/runtime tools.
- hazard: explicit loud gate for dangerous eval, setglobal, and call_function.

## Useful links

- Project site: https://liblua-with-mcp.buanzo.org/
- GitHub repository: https://github.com/buanzo/lua-mcp
- Latest branch: https://github.com/buanzo/lua-mcp/tree/liblua-mcp-latest
- Lua 5.4.8 proof branch: https://github.com/buanzo/lua-mcp/tree/liblua-mcp-5.4.8
- Lua 5.1 proof branch: https://github.com/buanzo/lua-mcp/tree/liblua-mcp-5.1
- MetaMCP Tools: https://github.com/buanzo/metamcp-tools
- MCP specification site: https://modelcontextprotocol.io/

## Status

Alpha research software for trusted local testing and architecture review. Not
production-ready and not security-reviewed for hostile environments.