# Cakephp Boost

> CakePHP-focused MCP server for augmenting your AI powered local development experience.

- **Type:** MCP server
- **Install:** `agentstack add mcp-dereuromark-cakephp-boost`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [dereuromark](https://agentstack.voostack.com/s/dereuromark)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [dereuromark](https://github.com/dereuromark)
- **Source:** https://github.com/dereuromark/cakephp-boost

## Install

```sh
agentstack add mcp-dereuromark-cakephp-boost
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# CakePHP Boost Plugin

A development tool to enhance AI-assisted coding within CakePHP projects by providing essential context, structure, and introspection capabilities.

## Features

### Phase 1 - MVP (Current)

- **Documentation Search**: Fast, full-text search of CakePHP documentation using SQLite FTS5
- **Schema Introspection**: View database schema in human-readable format
- **MCP Server**: Model Context Protocol server for AI assistants (Claude Code, Cursor, etc.)
- **Console Commands**: Simple CLI interface for indexing and searching documentation
- **Sample Documentation**: Pre-loaded with 20+ common CakePHP patterns and examples

## Installation

### For Development (within this sandbox)

The plugin is already loaded in this project. Just run:

```bash
# Index documentation (run once or when updating docs)
bin/cake boost_index --clear

# Search documentation
bin/cake boost_search "your query here"
```

### For External Projects (when published)

```bash
composer require dereuromark/cakephp-boost --dev
```

Then add to your `config/plugins.php`:

```php
'Boost' => ['onlyCli' => true],
```

## Usage

### Indexing Documentation

Index CakePHP Book documentation:

```bash
# Index all documentation
bin/cake boost_index

# Clear existing index and re-index
bin/cake boost_index --clear

# Index only specific sources
bin/cake boost_index --source book
```

### Searching Documentation

Basic search:

```bash
bin/cake boost_search "belongsToMany"
```

Natural language queries:

```bash
bin/cake boost_search "how to save data"
bin/cake boost_search "how do I validate email fields"
bin/cake boost_search "what is the correct way to use transactions"
```

Filter by category:

```bash
bin/cake boost_search "validation" --category orm
bin/cake boost_search "controller" --category controller
```

Limit results:

```bash
bin/cake boost_search "query" --limit 5
```

### Available Categories

- `orm` - Database, models, tables, associations
- `controller` - Controllers, components, request/response
- `view` - Templates, helpers, rendering
- `validation` - Form validation, rules
- `authentication` - User authentication
- `authorization` - Access control, permissions
- `testing` - PHPUnit tests, fixtures
- `middleware` - Middleware stack
- `routing` - Routes, prefixes
- `email` - Mailer, sending emails
- `caching` - Cache configuration and usage
- `events` - Event system
- `console` - CLI commands

### MCP Server (AI Integration)

The plugin provides an MCP (Model Context Protocol) server for AI assistants like Claude Code:

```bash
# Start the MCP server
php bin/cake boost_mcp_server
```

**Available Tools:**
- `search_documentation` - Search CakePHP docs with natural language
- `get_database_schema` - Get database schema information

**Configuration for Claude Code:**

Create `.claude/mcp_config.json` in your project:

```json
{
  "mcpServers": {
    "cakephp-boost": {
      "command": "php",
      "args": ["bin/cake", "boost_mcp_server"]
    }
  }
}
```

See [MCP_SETUP.md](MCP_SETUP.md) for detailed configuration instructions.

## How It Works

1. **Indexing**: The `boost_index` command parses CakePHP documentation and stores it in a SQLite database with full-text search (FTS5) enabled
2. **Searching**: The `boost_search` command performs fast full-text queries against the indexed documentation
3. **Results**: Returns relevant documentation snippets with titles, URLs, and context

## Database

Documentation is stored in: `tmp/boost/documentation.db`

The database uses SQLite's FTS5 (Full-Text Search) with Porter stemming for intelligent word matching.

## Current Limitations (MVP)

- **Sample Data Only**: Currently uses pre-defined documentation snippets
- **No Real-Time Updates**: Documentation must be manually re-indexed
- **No API Docs**: Only CakePHP Book content is indexed (API docs coming in Phase 2)
- **Basic Search**: Keyword-based search only (semantic search coming in Phase 2)

## Roadmap

### Phase 2 - Semantic Search (Planned)

- Generate embeddings for documentation using OpenAI or local models
- Vector similarity search for context-aware results
- Better understanding of natural language queries

### Phase 3 - Guidelines & Integration (Planned)

- CakePHP 5.x coding guidelines
- Popular plugin guidelines (Tools, Shim, Authentication, etc.)
- Auto-generated context files for Claude Code

### Phase 4 - MCP Server (Optional)

- Model Context Protocol server for AI assistants
- Real-time application introspection
- Database schema access for AI

## Examples

### Find Association Documentation

```bash
$ bin/cake boost_search "belongsToMany"

Found 1 results:

1. Associations - BelongsToMany [book]
   Category: orm
   URL: https://book.cakephp.org/5/en/orm/associations.html#belongstomany
   The belongsToMany association is used when two models are associated through a join table...
```

### Find Validation Examples

```bash
$ bin/cake boost_search "validation"

Found 2 results:

1. Form Validation - Custom Validators [book]
   Category: validation
   URL: https://book.cakephp.org/5/en/core-libraries/validation.html#custom-validation-rules
   Create custom validation rules as methods in your Table class...

2. Validation Rules [book]
   Category: validation
   URL: https://book.cakephp.org/5/en/core-libraries/validation.html
   Add validation rules in your Table class validationDefault() method...
```

## Contributing

This is currently an internal plugin in the Sandbox project. Once extracted to a separate repository, contributions will be welcome!

## License

MIT License

## Credits

Inspired by [Laravel Boost](https://github.com/laravel/boost)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [dereuromark](https://github.com/dereuromark)
- **Source:** [dereuromark/cakephp-boost](https://github.com/dereuromark/cakephp-boost)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-dereuromark-cakephp-boost
- Seller: https://agentstack.voostack.com/s/dereuromark
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.