🚀 Base API Scramble — MCP Server

MCP (Model Context Protocol) server yang expose seluruh dokumentasi base-api-scramble sebagai knowledge base untuk AI (Claude, Cursor, Copilot, dll).

Dengan MCP ini, AI langsung paham:

• Arsitektur & flow request project
• Konvensi wajib (UUID, Queryable, ApiResponse)
• Cara pakai artisan gc & gc:from-migration
• Pattern Model / Query Class / Controller / FormRequest
• FileService, Export Excel, Auth endpoints, dsb.

📦 Struktur

base-api-mcp/
├── index.js          ← MCP Server utama
├── package.json
├── docs/             ← Copy dari base-api-scramble/docs/
│   ├── starting_point.md
│   ├── AI-GUIDE-COMPLETE.md
│   ├── STRUCTURE.md
│   ├── README.md
│   ├── EXCEL-EXPORT-SERVICE.md
│   ├── EXPORT-DATA-PROVIDERS.md
│   ├── EXPORT-TEMPLATES.md
│   ├── LARAVEL-API-TEST.md
│   └── MAKE-EXPORT-EXCEL-COMMAND.md
└── README.md

🛠 Tools yang Tersedia

| Tool | Deskripsi | |---|---| | get_starting_point | Kickoff guide: quick start, stack, konvensi — mulai dari sini | | get_architecture | Arsitektur lengkap, flow, pattern code | | get_structure | Struktur direktori project | | get_conventions | Aturan wajib: Model, Migration, Query, Controller, Route | | get_commands | Referensi artisan gc commands + field type mapping | | get_api_response_format | Format JSON response + semua method ApiResponse | | get_query_params | Semua query parameter (search, filter, sort, include, dll) | | get_file_service | Cara upload/delete file dengan FileService | | get_export_guide | Excel export system (PhpSpreadsheet + Data Provider) | | get_auth_endpoints | Endpoint auth, RBAC, file management bawaan | | list_docs | Daftar semua file doc yang tersedia | | get_doc | Baca isi lengkap 1 file doc | | search_docs | Full-text search di semua docs |

⚙️ Setup

1. Install dependencies (sudah dilakukan)

cd /Users/sunarta25/gotra/CLI/base-api-mcp
npm install

2. Tambahkan ke Claude Desktop

Edit file: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "base-api-scramble": {
      "command": "node",
      "args": ["/Users/sunarta25/gotra/CLI/base-api-mcp/index.js"]
    }
  }
}

Jika sudah ada mcpServers lain, cukup tambahkan key "base-api-scramble" di dalam object yang sudah ada.

3. Restart Claude Desktop

Tutup & buka kembali Claude Desktop. MCP server akan aktif otomatis.

⚙️ Setup Cursor

Edit .cursor/mcp.json di root project atau ~/.cursor/mcp.json untuk global:

{
  "mcpServers": {
    "base-api-scramble": {
      "command": "node",
      "args": ["/Users/sunarta25/gotra/CLI/base-api-mcp/index.js"]
    }
  }
}

🔄 Update Docs

Jika docs di base-api-scramble diupdate, sync ulang dengan:

cp -r /Users/sunarta25/gotra/base-api-scramble/docs/* \
      /Users/sunarta25/gotra/CLI/base-api-mcp/docs/

🧪 Test Manual

cd /Users/sunarta25/gotra/CLI/base-api-mcp
npm start

Server berjalan via stdio — digunakan oleh Claude/Cursor secara otomatis.

💡 Cara Pakai di Claude

Setelah setup, Claude bisa langsung pakai tools ini. Contoh prompt:

Gunakan get_starting_point untuk memahami project, lalu buatkan module Product
dengan fields: name, price, stock, image (file), category (relasi).

Cari informasi tentang FileService menggunakan search_docs

Tampilkan semua endpoint auth yang tersedia menggunakan get_auth_endpoints