@recursica/mcp

An adapter-agnostic Model Context Protocol (MCP) server for the Recursica design system.

This MCP server provides a suite of tools for AI assistant agents (like Gemini, Antigravity, or Claude) to dynamically inspect, query, and consume custom UI components in your active adapters.

Dynamic Tooling Offered

• recursica_get_usage: Returns architectural design rules, component usage patterns, and styling token guidelines.
• recursica_list_components: Lists all available custom components across active adapters (e.g. mantine-adapter, mui-adapter).
• recursica_get_component_doc: Displays full component notes, API types, and .tsx source code signatures.
• recursica_recommend_component: Recommends the ideal component based on your UI layout constraints or keywords.
• recursica_project_setup: Serves installation and setup guides for projects integrating Recursica.
• what_is_recursica: Provides general documentation on what Recursica is, its core philosophy, and setup overview.

Installation & Usage

For instructions on how to set up and run the Recursica MCP server in your environment using npx, see the SETUP.md guide.

Local Development Setup

To test and run this server locally during development:

1. Run the Visual MCP Inspector

You can also inspect and visually test the server tools in an interactive playground:

1. Start the development inspector server:

   npm run dev

2. The inspector will automatically open the playground interface in your browser (usually at http://localhost:6274), which hot-reloads on-the-fly as you modify the source files.

2. Register the Local Server in your Client

Configure your MCP client (such as VS Code, Gemini, or Antigravity) to run the TypeScript source files directly using tsx (which requires no manual compile/build steps to see code changes):

"recursica-mcp": {
  "command": "npx",
  "args": [
    "tsx",
    "/absolute/path/to/recursica/packages/recursica-mcp/src/index.ts"
  ]
}