Starasia Admin MCP Server

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

Dokumentasi instalasi untuk Claude Code, Codex CLI, dan client MCP lain ada di docs/INSTALLATION.md.

Fitur

• list_components: daftar komponen yang tersedia via @starasia/admin
• search_components: pencarian komponen berdasarkan nama atau use case
• get_component: detail deskripsi, kategori, file sumber, anggota namespace, dan contoh penggunaan
• get_component_code: generate snippet JSX awal

Server ini membaca source dari repo Starasia target, jadi katalog mengikuti komponen yang benar-benar tersedia di folder starasia-* dan yang direexport oleh starasia-admin/src/index.ts.

Menjalankan

cd starasia-admin-mcp
npm test
STARASIA_REPO_ROOT=/absolute/path/to/starasia-repo node src/server.js

Quick Start

Jika ingin langsung mendaftarkan server ini ke client MCP yang memakai format JSON mcpServers, gunakan:

{
  "mcpServers": {
    "starasia-admin": {
      "command": "node",
      "args": [
        "/Users/bayudwisatriyo/developer/working-area/spt/component/starasia-admin-mcp/src/server.js",
        "--repo-root",
        "/absolute/path/to/starasia-component-repo"
      ]
    }
  }
}

Jika package ini sudah dipublish ke npm, command yang lebih portabel adalah:

{
  "mcpServers": {
    "starasia-admin": {
      "command": "npx",
      "args": [
        "-y",
        "@starasia/admin-mcp",
        "--repo-root",
        "/absolute/path/to/starasia-component-repo"
      ]
    }
  }
}

Contoh konfigurasi MCP

{
  "mcpServers": {
    "starasia-admin": {
      "command": "node",
      "args": [
        "/Users/bayudwisatriyo/developer/working-area/spt/component/starasia-admin-mcp/src/server.js",
        "--repo-root",
        "/absolute/path/to/starasia-component-repo"
      ]
    }
  }
}

Catatan

• Import yang disarankan selalu melalui @starasia/admin
• Fokus server ini adalah discovery dan contoh penggunaan, bukan introspeksi type-level penuh
• Repo target harus diberikan lewat STARASIA_REPO_ROOT atau --repo-root
• Jika Anda menambah komponen baru ke starasia-admin/src/index.ts, katalog akan ikut terbaca saat server target dijalankan ulang
• Untuk panduan setup agent-by-agent, lihat docs/INSTALLATION.md