FUI MCP Server

MCP server for FUI low-code system — manage projects, modules, components, and database via AI.

Quick Start

No installation required:

npx @fui-org/fui-mcp

Configuration

Required Environment Variables

| Variable | Description | |---|---| | FUI_API_TOKEN | Bearer token from your FUI account | | FUI_API_BASE | FUI API base URL, e.g. https://api.fui.vn | | FUI_MCP_WORKDIR | Local workspace root (default: ~/.fui-mcp/workspaces) |

1. Claude Code (CLI) — Recommended

claude mcp add fui-local -s user \
  -e "FUI_API_TOKEN=your_token" \
  -e "FUI_API_BASE=https://api.fui.vn" \
  -e "FUI_MCP_WORKDIR=/your/workspace/path" \
  -- npx -y @fui-org/fui-mcp

2. Claude Desktop

Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "fui-local": {
      "command": "npx",
      "args": ["-y", "@fui-org/fui-mcp"],
      "env": {
        "FUI_API_TOKEN": "your_token",
        "FUI_API_BASE": "https://api.fui.vn",
        "FUI_MCP_WORKDIR": "/your/workspace/path"
      }
    }
  }
}

3. SSE Mode (HTTP server)

Run as an HTTP/SSE server to connect from web clients or remote tools:

npx @fui-org/fui-mcp --sse
# Listening on http://localhost:3001

# Custom port:
npx @fui-org/fui-mcp --sse --port 8080

Recommended Workflow

1. Call module_get with /projectId/moduleId (or projectId + moduleId) to fetch the module into the local workspace — also sets the active session target (metadata comes from the local modules/_modules.json cache, which the tool refreshes from the server by itself on a cache miss)
2. Read lowcode://skill/fui or call skill_get for FUI coding guidelines
3. Edit local files in {workspaceRoot}/{projectId}/modules/{moduleId}/
4. Call module_preview to review staged changes before publishing
5. Call module_publish_html / module_publish_json / module_publish_script / component_new (first push of a .vue) or component_update (later pushes) to send the changed files back to FUI

Creating and editing are always separate tools — nothing upserts silently. Create with module_new, component_new, project_new, file_import_new, right_system_new, right_function_new (a brand-new stored procedure goes through db_sp_save → db_sp_deploy). Every *_update tool needs the record's identifier and fails loudly without it.

Resources

| URI | Description | |---|---| | lowcode://modules/{projectId}/{moduleId} | Module content | | lowcode://components/{projectId}/{moduleId} | Module components | | lowcode://script/{projectId}/{moduleId} | Module script | | lowcode://dependencies/{projectId}/{moduleId} | Module dependencies | | lowcode://library/v2 | Full FUI V2 library | | lowcode://library/v2/component | Component definitions | | lowcode://library/v2/componentTable | Component table layout | | lowcode://library/v2/defaultfunction | Default function library | | lowcode://library/v2/fastproject | Fast project templates | | lowcode://library/v2/defaultstyle | Default CSS styles | | lowcode://skill/fui | FUI skill summary (concise) | | lowcode://skill/fui/raw | Full bundled SKILL.md |

Prompts

| Prompt | Description | |---|---| | generate-vue-component | Generate a Vue 2 component for FUI |

Development

# Install dependencies
npm install

# Build
npm run build

# Run in SSE mode
npm start

Requires Node.js >= 18.