Skeleton Svelte MCP

A local, stdio MCP server that gives coding agents searchable access to the official Skeleton documentation, 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.

npm install
npm run build

Codex configuration

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

[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:

git tag v0.1.0
git push origin v0.1.0

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

[mcp_servers.skeleton-svelte]
command = "npx"
args = [
  "--yes",
  "--package=github:mxmauro/mcp-skeleton-dev#v0.1.0",
  "skeleton-svelte-mcp"
]

v0.1.0 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. Copyright (c) 2026 Mauro H. Leggieri.