@stencil/mcp

A Model Context Protocol server that gives AI coding agents accurate, version-aware knowledge of a StencilJS project.

Proof-of-concept for stenciljs/core#6518.

Why

AI agents frequently suggest non-idiomatic Stencil code — e.g. manually adding a window.addEventListener in componentWillLoad instead of using the built-in @Listen() decorator, or mutating a @Prop. This server exposes Stencil's real API surface and best practices to the agent so it can self-correct, and tells it which Stencil version the project is actually running.

Related MCP server: Context7 MCP

Tools

All reference content is sourced from Stencil's own public runtime type declarations, so it matches the framework rather than guessing.

Usage

npm install && npm run build

Register with an MCP-capable client (Claude Desktop, Cursor, VS Code, etc.):

{
  "mcpServers": {
    "stencil": {
      "command": "npx",
      "args": ["-y", "@stencil/mcp"]
    }
  }
}

Develop

npm run build      # compile TypeScript
npm test           # unit tests (node:test)
node test/smoke.mjs # end-to-end MCP stdio test

License

MIT