Flexoki MCP Server

MCP server for generating and integrating Flexoki theme setup across web projects.

What this server provides

• Tools:
  • setup-flexoki-project: Full project setup bundle for React, Next.js, Vue, or static HTML.
  • generate-tailwind-config: Tailwind v3 config or Tailwind v4 @theme config generation.
  • generate-flexoki-component: Framework-specific example component generation.
• Resources:
  • template://flexoki/css
  • template://flexoki/theme-js
  • template://flexoki/toggle-js
  • config://tailwind/v3-base
  • config://tailwind/v4-theme
• Prompts:
  • setup-guide
  • troubleshoot
  • customization

Architecture Visualization

flowchart TD
  U[User in Claude or Copilot] --> C[MCP Client]
  C -->|STDIO JSON-RPC| S[flexoki-mcp-server]

  S --> R[Router and Validation]

  R --> T1[Tool: setup-flexoki-project]
  R --> T2[Tool: generate-tailwind-config]
  R --> T3[Tool: generate-flexoki-component]

  R --> RS[Resources]
  RS --> RS1[template://flexoki/css]
  RS --> RS2[template://flexoki/theme-js]
  RS --> RS3[template://flexoki/toggle-js]
  RS --> RS4[config://tailwind/v3-base]
  RS --> RS5[config://tailwind/v4-theme]

  R --> P[Prompts]
  P --> P1[setup-guide]
  P --> P2[troubleshoot]
  P --> P3[customization]

  T1 --> G[Codegen Layer]
  T2 --> G
  T3 --> G
  G --> O[Generated files and instructions]
  O --> C
  C --> U

Requirements

• Node.js 18+

Local development

npm install
npm run build
npm run test
npm run dev

VS Code configuration

Add server configuration to .vscode/mcp.json (workspace) or your user profile MCP config.

Recommended: npm package via npx

{
  "servers": {
    "flexoki": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@raghav-56/flexoki-mcp-server"]
    }
  }
}

Alternative: local checkout

Build first:

npm install
npm run build

Then configure VS Code:

{
  "servers": {
    "flexoki": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/dist/index.js"]
    }
  }
}

If your repository is nested (for example, workspace/flexoki-mcp-server), adjust the path accordingly (for example, ${workspaceFolder}/flexoki-mcp-server/dist/index.js).

When tools or prompts change, run MCP: Reset Cached Tools in VS Code.

Claude Desktop configuration

Recommended: Global Installation

Install the server globally:

npm install -g @raghav-56/flexoki-mcp-server

Then add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "flexoki": {
      "command": "flexoki-mcp-server",
      "type": "stdio"
    }
  }
}

Alternative: Local Installation

If you prefer a project-specific installation, clone the repository and build it locally:

git clone <repo-url>
cd flexoki-mcp-server
npm install
npm run build

Then add this to your claude_desktop_config.json (replace the path):

{
  "mcpServers": {
    "flexoki": {
      "command": "node",
      "args": ["/absolute/path/to/flexoki-mcp-server/dist/index.js"],
      "type": "stdio"
    }
  }
}

Publish to npm

npm run build
npm test
npm publish --access public

Example interactions

• "Set up Flexoki for my Next.js app using Tailwind v4."
• "Generate a Tailwind v3 config using flexoki-theme.js."
• "Generate a Vue card component with Flexoki semantic tokens."