@greese/mcp 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chris Moody
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,63 @@
-# Temporary Holding Version
+# @greese/mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+An [MCP](https://modelcontextprotocol.io) server for greese ui. It gives a
+coding assistant the facts it needs to write greese ui code instead of guessing
+them:
+
+- the components;
+- their props;
+- the classes a theme can target;
+- tokens and icons;
+- the guides;
+- the shape themes;
+- complete page templates.
+
+It answers for the greese ui version it was built with.
+
+## Set up
+
+Claude Code:
+
+```sh
+claude mcp add greese -- npx -y @greese/mcp
+```
+
+Any client that takes a JSON config (Claude Desktop, Cursor, VS Code…):
+
+```json
+{
+  "mcpServers": {
+    "greese": { "command": "npx", "args": ["-y", "@greese/mcp"] }
+  }
+}
+```
+
+It runs over stdio and needs Node 24 or later.
+
+## Tools
+
+| Tool                             | What it returns                                                                                                                                       |
+| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `list_components`                | Every component by docs category, one line each                                                                                                       |
+| `get_component`                  | A component's description, every prop (type, default, meaning), its classes, parts, modifiers and CSS variables, and its stories file as example code |
+| `search`                         | Components, guides, templates and themes that match some words                                                                                        |
+| `list_tokens`                    | Design tokens as CSS custom properties, by group                                                                                                      |
+| `list_icons`                     | The icons in `@greese/icons`                                                                                                                          |
+| `create_theme`                   | The CSS of a theme built with `createTheme(options)`                                                                                                  |
+| `list_templates`, `get_template` | Page templates (finance, admin dashboard, email client, blog, SaaS, store) and their source                                                           |
+| `list_themes`, `get_theme`       | Shape themes (clip-path and masks), as kit SCSS or compiled CSS                                                                                       |
+
+## Resources
+
+- `greese://guides/<name>`: the guides (Getting started, Theming, Styling…).
+- `greese://components/<Name>`: one document per component.
+
+## Programmatic use
+
+```ts
+import { createGreeseServer, loadData } from '@greese/mcp'
+
+const server = createGreeseServer(loadData()) // an McpServer: connect any transport
+```
+
+See ADR 0022 for how it's built.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { loadData } from "./data.js";
+import { createGreeseServer } from "./server.js";
+// stdout carries the protocol: anything else goes to stderr.
+await createGreeseServer(loadData()).connect(new StdioServerTransport());
+console.error('greese ui MCP server running on stdio');

package/dist/data.d.ts

@@ -0,0 +1,60 @@
+/** One prop of a component, as its TSDoc describes it. */
+export interface PropDoc {
+    name: string;
+    type: string;
+    required: boolean;
+    default?: string;
+    description: string;
+}
+/** A component's entry in the style manifest (ADR 0010): what a theme can target. */
+export interface StyleEntry {
+    className: string;
+    parts: string[];
+    modifiers: string[];
+    attributes: string[];
+    variables: string[];
+}
+export interface ComponentDoc {
+    name: string;
+    /** Its docs category: Layout, Forms, Content, Overlays, Navigation, Motion, Utilities. */
+    category: string;
+    description: string;
+    /** Where it lives, relative to the repository. */
+    file: string;
+    props: PropDoc[];
+    styles?: StyleEntry;
+    /** Its stories file: working usage, args first. */
+    example?: string;
+}
+export interface Guide {
+    name: string;
+    title: string;
+    text: string;
+}
+export interface ThemeDoc {
+    id: string;
+    description: string;
+    /** The kit source: compile it after greese ui's styles, or read it as a recipe. */
+    scss: string;
+    /** The same, compiled. */
+    css: string;
+}
+export interface Template {
+    id: string;
+    description: string;
+    source: string;
+}
+/** Everything the server answers from: dist/data.json, written at build time. */
+export interface GreeseData {
+    version: string;
+    components: ComponentDoc[];
+    tokens: Record<string, unknown>;
+    icons: string[];
+    guides: Guide[];
+    themes: ThemeDoc[];
+    templates: Template[];
+    /** The SCSS the templates share (their `tpl-*` classes). */
+    templateStyles?: string;
+}
+/** The data this build shipped with. */
+export declare const loadData: () => GreeseData;

package/dist/data.js

@@ -0,0 +1,3 @@
+import { readFileSync } from 'node:fs';
+/** The data this build shipped with. */
+export const loadData = () => JSON.parse(readFileSync(new URL('./data.json', import.meta.url), 'utf8'));