Starasia Admin MCP Server

MCP server untuk membantu AI agent FE memahami dan menggunakan komponen melalui @starasia/admin.

Package ini self-contained. Tidak perlu repo source lokal, tidak perlu repo-root, dan tidak perlu scan workspace tertentu.

Fitur

• list_components: daftar komponen yang tersedia via @starasia/admin
• search_components: pencarian komponen berdasarkan nama atau use case
• get_component: detail deskripsi, kategori, anggota namespace, dan contoh penggunaan
• get_component_code: generate snippet JSX awal
• suggest_component: rekomendasi komponen berdasarkan deskripsi UI
• plan_implementation: rencana implementasi ringkas berisi komponen utama, import, convention, langkah, hal yang perlu dihindari, plus matched page patterns dan ringkasan standards (checklist + import rules)
• list_conventions / get_convention: project-local convention seperti TableMaster (props, Column interface, contoh siap pakai)
• list_icons: daftar nama icon untuk <Icon name="..." />
• list_hooks: daftar hook yang diexport oleh @starasia/admin
• get_slicing_guidelines: standar slicing Starasia Admin (import rules, workflow, page patterns seperti app-shell, listing-table-page, detail-page, create-edit-form-page, auth-page, modal-or-drawer-flow, empty-error-states, upload-image-or-file, typography-status-badges, plus checklist, anti-patterns, dan utility cheatsheet). Panggil tool ini sebelum generate kode untuk satu screen, opsional dengan argumen pattern agar fokus ke satu pola.

Server ini dibangun sebagai knowledge server untuk package @starasia/admin, mirip pola penggunaan MCP package seperti hudoro-react.

Install

Install global:

npm install -g @starasia/admin-mcp

Jalankan manual untuk smoke test:

starasia-admin-mcp

Atau tanpa install global:

npx -y @starasia/admin-mcp

Claude Code

Install global lalu daftarkan ke Claude Code:

npm install -g @starasia/admin-mcp
claude mcp add --scope user starasia-admin -- starasia-admin-mcp

Alternatif tanpa install global:

claude mcp add --scope user starasia-admin -- npx -y @starasia/admin-mcp

Verifikasi:

claude mcp list
claude mcp get starasia-admin

Codex CLI

Quick command:

codex mcp add starasia-admin --command npx --args -y --args @starasia/admin-mcp

Fallback via ~/.codex/config.toml:

[mcp_servers.starasia_admin]
command = "npx"
args = ["-y", "@starasia/admin-mcp"]

JSON MCP Config

Untuk client lain yang memakai format JSON mcpServers:

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

Development

cd starasia-admin-mcp
npm test
node src/server.js

Catatan

• Import yang disarankan selalu melalui @starasia/admin
• Panggil get_slicing_guidelines (opsional dengan pattern) sebelum generate kode supaya output mengikuti standar slicing Starasia
• Gunakan plan_implementation untuk fitur utuh seperti dashboard shell, form create/edit, atau listing table — output sekarang juga membawa matchedPatterns, pagePatterns, dan ringkasan standards (checklist + import rules)
• Gunakan get_component sebelum generate kode jika komponen berupa namespace seperti Form, TableSection, PageState, atau AdvanceFilterBar
• Selalu cek list_conventions / get_convention untuk pola project-local seperti TableMaster sebelum jatuh ke primitive
• Fokus server ini adalah discovery, pattern guidance, dan contoh penggunaan, bukan introspeksi type-level penuh
• Server ini tidak membaca repo lokal; katalog yang dipakai adalah katalog statis penggunaan @starasia/admin
• Panduan setup detail per agent tersedia di file docs/INSTALLATION.md di package ini