# lunc-mcp

[![CI](https://github.com/Semence2Porc/lunc-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Semence2Porc/lunc-mcp/actions/workflows/ci.yml)

A [Model Context Protocol](https://modelcontextprotocol.io) server for the
**Terra Classic** blockchain — gives MCP-capable agents a verified, structured
corpus of Terra Classic engineering findings, plus the companion agent skills
published at [Semence2Porc/lunc-skills](https://github.com/Semence2Porc/lunc-skills).

Every finding in the registry originates from a shipped, peer-reviewable PR with
a reproducing test — not folklore. Skills fetched from `lunc-skills` cross-link
into this registry for machine-readable detail and runnable freshness checks.

> **Status: v0.1.0 — early, testnet-oriented.** Interfaces may change.

## Requirements

- Node.js ≥ 22

## Usage

```bash
npm start            # run the MCP server (stdio)
npm run self-test    # built-in sanity check
npm test             # unit tests (node --test)
```

Register it with your MCP client (example, Claude Desktop `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "lunc-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/lunc-mcp/server/lunc-mcp.mjs"]
    }
  }
}
```

## Layout

| Path | Contents |
|---|---|
| `server/` | MCP stdio server (`lunc-mcp.mjs`), findings store, schema |
| `registry/` | Machine-readable finding registry (the skills' source of truth) |
| `canister/` | Internet Computer canister port of the registry access |
| `test/` | `node --test` unit tests |

## Related

- [Semence2Porc/lunc-skills](https://github.com/Semence2Porc/lunc-skills) — the
  agent skills (icskills format) built on this registry.

## License

MIT — see [LICENSE](LICENSE).