🏗️ Gotrasoft Base API

The Missing Brain for Your Laravel API Agent.

Just as a developer needs a handbook to understand a codebase, AI Agents need structured knowledge to write correct code. Gotrasoft Base API gives your Agent instant, deep understanding of the Laravel Base API architecture—so it never guesses conventions, never invents wrong patterns, and always generates production-ready code.

Powered by the Model Context Protocol (MCP), this server connects your local AI (running on Claude Desktop, VS Code, or Cursor) directly to the full knowledge base: architecture, code conventions, artisan commands, response formats, and more.

✨ Key Features

📖 Instant Architecture Knowledge: Ask your Agent how the project is structured and it will know—flow, layers, dependencies, and the 5 core components.

⚡ Convention Enforcement: Prevent the AI from generating wrong code. UUID primary keys, Queryable trait, ApiResponse methods—all enforced through structured tools.

🛠 Artisan GC Commands: Full reference for php artisan gc and gc:from-migration commands, including field type mapping (Indonesian → English auto-detection).

🔍 Full-Text Search: Search across all 9 documentation files in milliseconds. Find anything—class names, patterns, config keys.

📦 Complete Code Patterns: Ready-to-use patterns for Model, Query Class, Controller, FormRequest, Route, FileService, Excel Export, and Auth endpoints.

🤖 AI-First Design: Every tool is written as a clear, structured prompt—so AI agents consume it naturally without hallucinations.

📦 Installation

Global Installation (Recommended)

Make it available everywhere on your system:

npm install -g gotrasoft-base-api

Run via npx

Run it on-demand without installing:

npx -y gotrasoft-base-api

🛠️ Setup & Configuration

Integrate Gotrasoft Base API into your favorite AI tools.

🧩 VS Code (MCP Extension)

Add this to your MCP configuration (.vscode/mcp.json or global ~/.cursor/mcp.json):

{
  "mcpServers": {
    "gotrasoft-base-api": {
      "command": "npx",
      "args": ["-y", "gotrasoft-base-api"]
    }
  }
}

🤖 Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "gotrasoft-base-api": {
      "command": "npx",
      "args": ["-y", "gotrasoft-base-api"]
    }
  }
}

💡 Usage Examples

This server provides 13 tools to your Agent:

1. get_starting_point

The first tool to call when starting work on the project.

"Use get_starting_point to understand this project before writing any code."

Returns: quick start commands, tech stack, full architecture, conventions, and new project checklist.

2. get_architecture

Deep dive into how the project is structured.

"Use get_architecture to understand how CRUD works in this project."

Returns: request flow, 5 core components, Migration-First vs Fields-First workflows, complete code patterns.

3. get_conventions

Enforce correct code patterns before generating.

"Use get_conventions before creating a new module."

Returns: Model (UUID + Queryable), Migration (uuid primary), Query Class, Controller (ApiResponse + baseQuery), FormRequest (@example), Route naming.

4. get_commands

Full artisan GC command reference.

"Use get_commands to find the right artisan command for generating a module with file upload."

Returns: gc, gc:from-migration, gc:wizard with all options, field type mapping, decision logic.

# Examples the Agent will know:
php artisan gc Product --fields="name,price:decimal,image:file" --belongsTo="Category"
php artisan gc:from-migration products

5. search_docs

Find anything across all documentation.

"Search for 'FileService' in the docs."

Output:

# Search Results: "FileService"
Found 12 lines in 3 files

## AI-GUIDE-COMPLETE.md (8 matches)
Line 142:
  $this->fileService->saveFileComplete(...)

6. get_api_response_format

"What is the standard JSON response format for this project?"

Returns all ApiResponse methods and their exact JSON output.

7. get_query_params

"What query parameters does the index endpoint support?"

Returns: search, filter[], sort_by, sort_order, include, paginate, first, fields[] with examples.

8. get_file_service

"How do I handle file upload in a controller?"

Returns: saveFileComplete(), deleteFile(), update pattern, storage config, compression support.

9. get_auth_endpoints

"What auth and RBAC endpoints are already available?"

Returns: login/logout/profile endpoints, Role & Permission CRUD, default credentials, required headers.

10. get_export_guide

"How does the Excel export system work?"

Returns: BaseExport, Data Provider pattern, template types, config file.

11. list_docs

"Show all available documentation files."

Returns a list of all 9 docs with descriptions.

12. get_doc

"Read the full content of LARAVEL-API-TEST.md"

Returns the complete file content.

13. get_structure

"What is the full directory structure of this project?"

Returns the complete annotated project tree.

🏗️ Architecture

AI Agent (Claude / Cursor / VS Code)
        │
        │  MCP Protocol (stdio)
        ▼
gotrasoft-base-api (Node.js MCP Server)
        │
        ▼
docs/ (9 Markdown files — Laravel knowledge base)
├── starting_point.md        ← Quick start & conventions
├── AI-GUIDE-COMPLETE.md     ← Full architecture & patterns
├── STRUCTURE.md             ← Directory tree
├── EXCEL-EXPORT-SERVICE.md  ← Export system
├── EXPORT-DATA-PROVIDERS.md ← Data provider pattern
├── EXPORT-TEMPLATES.md      ← Excel templates
├── LARAVEL-API-TEST.md      ← Testing guide
├── MAKE-EXPORT-EXCEL-COMMAND.md
└── README.md

🔗 Explore the Ecosystem

Build a complete AI development toolkit with our other MCP servers:

📡 Gotrasoft Webhook Real-Time Webhook Reception for AI Agents. Generate public URLs and receive live payloads from Stripe, GitHub, Zapier, or any API. → npmjs.com/package/gotrasoft-webhook

📮 Gotrasoft Postman The Ultimate API Tester. Execute HTTP requests with full Auth support (Bearer, Basic, API Key) directly from your Agent.

🐬 Gotrasoft MySQL Safe Database Exploration. Inspect schemas and run queries on your databases without leaving your AI workflow.

📄 License

MIT © I Komang Gede Yuliana

Built with ❤️ by Gotrasoft for the AI-native future.