# Skeleton Svelte MCP

A local, stdio MCP server that gives coding agents searchable access to the official [Skeleton documentation](https://www.skeleton.dev/llms-full.txt), with a focus on Svelte usage.

## What it provides

- `search_skeleton_docs`: ranked official documentation sections for a task or API query.
- `get_skeleton_section`: a full named section, such as `Accordion` or `Installation`.
- `skeleton_svelte_guidance`: Svelte-oriented excerpts for an implementation task.
- `skeleton://documentation/full`: the complete official documentation as an MCP resource.

Documentation is retrieved only from Skeleton's published `llms-full.txt`, kept in memory for one hour, and refreshed after that. If a refresh fails, the last successful copy remains available for the process lifetime.

## Install and build

Requires Node.js 20 or later.

```sh
npm install
npm run build
```

## Codex configuration

Add this server to your Codex MCP configuration, replacing `{base-folder}` with the directory containing this project:

```toml
[mcp_servers.skeleton-svelte]
command = "node"
args = ["{base-folder}\\dist\\index.js"]
```

For development, use `npx tsx {base-folder}\\src\\index.ts` as the command and arguments instead.

The server uses stdout exclusively for MCP JSON-RPC; operational logs must go to stderr.

## Run directly from GitHub

The compiled `dist/` folder is intentionally committed, so Codex can download and run a tagged GitHub release without a local clone. Create and push a Git tag that matches the release, for example:

```sh
git tag v0.1.1
git push origin v0.1.1
```

Then configure Codex to install and run that immutable release through `npx`:

```toml
[mcp_servers.skeleton-svelte]
command = "npx"
args = [
  "--allow-git=all",
  "--yes",
  "--package=github:mxmauro/mcp-skeleton-dev#v0.1.1",
  "skeleton-svelte-mcp"
]
```

`v0.1.1` is a Git tag, not merely the `version` value in `package.json`. Every tagged release must include `package.json`, `package-lock.json`, and a freshly built `dist/` directory. Node.js, npm, GitHub access, and network access are required on the machine where Codex starts the server.

## License

Licensed under the [MIT License](LICENSE). Copyright (c) 2026 Mauro H. Leggieri.