# lmcp — Lua MCP server

Lightweight Model Context Protocol (MCP) server in pure Lua.

## Runtime dependencies

- Lua 5.1+
- [luasocket](https://github.com/lunarmodules/luasocket) — needed for the TCP
  listener. Packaged as `lua-socket` on Arch/ALARM, `lua-socket` on Debian.

## Files

| File | Role |
|------|------|
| `lmcp.lua`         | library: protocol handling, tool registration |
| `server.lua`       | HTTP server loop |
| `json.lua`         | vendored JSON encoder/decoder |
| `example_server.lua` | sample server with a couple of tools |

## Install

Packaged as `lmcp` in the marfrit overlay repo:

```
# Arch / ALARM
sudo pacman -S lmcp

# Debian
sudo apt install lmcp
```

Files land under `/usr/share/lua/5.4/` (Lua LUA_PATH).
The example server installs as `/usr/bin/lmcp-example`.