ServerPod Boost

AI acceleration for ServerPod development via MCP (Model Context Protocol)

ServerPod Boost is an MCP server that provides AI assistants (like Claude) with deep semantic understanding of ServerPod projects, enabling high-quality code generation through context-aware tool access.

Version 0.1.6 - Enhanced Built-in Resources

• ✅ Built-in Skills: 8 skill categories now included (authentication, core, endpoints, migrations, models, redis, testing, webhooks)
• ✅ ServerPod CLI Commands: 8 built-in commands now available (run, migrate, generate, test, docker, cloud, analyze, format)
• ✅ Database SSL Fix: SSL mode defaults to disable for local development
• ✅ Tools: 19 MCP tools (removed tinker)

What is ServerPod Boost?

Inspired by Laravel Boost, ServerPod Boost gives AI assistants:

• Project Awareness: Automatic detection of ServerPod v3 monorepo structure
• Endpoint Intelligence: Parse and understand all endpoint methods with signatures
• Model Understanding: Read protocol model definitions from source .spy.yaml files
• Database Context: Access migration files and database schemas
• Configuration Access: Read all YAML config files
• Code Search: Full-text search across source code
• Built-in Skills: 8 pre-built skill categories for common ServerPod tasks
• Built-in Commands: ServerPod CLI commands readily accessible

Quick Start

1. Install Boost

# Navigate to your ServerPod project's server directory
cd your_project_server

# Add as dev dependency
dart pub add serverpod_boost --dev

# Install everything (guidelines, skills, MCP config)
dart run serverpod_boost:install

# Or using the boost command
dart run serverpod_boost:boost install

That's it! The installer will:

• ✓ Detect your ServerPod project structure
• ✓ Create the .ai/boost directory
• ✓ Copy all necessary files
• ✓ Set up local development overrides
• ✓ Generate AGENTS.md and CLAUDE.md documentation
• ✓ Configure Claude Desktop automatically
• ✓ Install default skills

2. Configure Claude Desktop

The install command automatically creates a wrapper script run-boost.sh in your project. Add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "serverpod-boost": {
      "command": "/path/to/your/project/run-boost.sh"
    }
  }
}

The run-boost.sh wrapper script is automatically created by the install command and handles all the complexity for you - no need to worry about global installations or system-specific paths.

Configuration file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

See examples/ directory for complete configuration samples.

3. Restart Claude & Start Coding

Ask Claude anything about your ServerPod project:

• "What endpoints exist in this project?"
• "Create a new endpoint for user management"
• "Show me the database schema for the users table"
• "Generate a test for the greeting endpoint"
• "List available ServerPod CLI commands"
• "Show me built-in skills for authentication"

Features

19 Built-in Tools

Tool	Description
application_info	Complete project overview
list_endpoints	List all endpoints
endpoint_methods	Get endpoint method details
list_models	List all protocol models
model_inspector	Inspect model fields
config_reader	Read YAML configs
database_schema	Get database schema
migration_scanner	List migrations
project_structure	File tree browser
find_files	Find files by pattern
read_file	Read file content
search_code	Search code content
call_endpoint	Test endpoints
service_config	Service configuration
list_skills	List built-in and custom skills
get_skill	Get skill content
log_reader	Read ServerPod logs
database_query	Query database (SSL: disable by default)
cli_commands	List ServerPod built-in and custom commands

8 Built-in Skills

ServerPod Boost includes 8 categories of pre-built skills:

Category	Description
authentication	User authentication and authorization workflows
core	Core ServerPod concepts and patterns
endpoints	Endpoint creation and best practices
migrations	Database migration workflows
models	Protocol model definition patterns
redis	Caching with Redis
testing	Testing strategies and patterns
webhooks	Webhook implementation

ServerPod CLI Commands

The cli_commands tool returns 8 built-in ServerPod commands:

Command	Description
run	Start the ServerPod server
migrate	Create and apply database migrations
generate	Generate protocol buffers and models
test	Run tests
docker	Manage Docker containers
cloud	Deploy to Serverpod Cloud
analyze	Analyze code quality
format	Format Dart code

CLI Commands

# Installation
dart run serverpod_boost:install              # Install (interactive by default)
dart run serverpod_boost:install --non-interactive  # Silent install
dart run serverpod_boost:boost install        # Same as above

# Skills
dart run serverpod_boost:boost skill:list     # List available skills
dart run serverpod_boost:boost skill:show <name>  # Show skill details

Project Structure

ServerPod Boost understands ServerPod's 3-package monorepo:

your_project/
├── project_server/    # Source of truth
│   ├── lib/src/
│   │   ├── **/*_endpoint.dart
│   │   └── **/*.spy.yaml
│   └── config/
├── project_client/    # Generated (Boost reads this too)
└── project_flutter/   # Flutter app

Boost creates these directories:

your_project/
├── .ai/
│   ├── boost/
│   │   ├── bin/              # Boost executable
│   │   ├── skills/           # Local skills directory
│   │   └── config/           # Local configuration
│   ├── AGENTS.md             # Generated AI documentation
│   └── CLAUDE.md             # Generated Claude instructions

Requirements

• Dart: 3.8.0 or higher
• ServerPod: 3.2.3 or higher
• Project: Valid ServerPod v3 monorepo structure

Development

# Run tests
dart test

# Run with coverage
dart test --coverage=coverage

# Analyze code
dart analyze

# Run with verbose output
dart run bin/boost.dart --verbose

# Using the boost command wrapper
boost info
boost endpoints --detailed
boost models

Documentation

• 사용자 가이드 (User Guide) - 완전한 사용 설명서 (설치, 빠른 시작, MCP 도구, 스킬 시스템, CLI 명령어)
• CLI 명령어 레퍼런스 (CLI Reference) - 모든 CLI 명령어 상세 설명
• MCP 도구 레퍼런스 (MCP Tools Reference) - 19개 MCP 도구 상세 문서
• 스킬 개발 가이드 (Skills Development Guide) - 커스텀 스킬 만들기
• AGENTS.md - AI 에이전트를 위한 프로젝트 문서

Testing

Boost includes 400+ tests covering:

• Tool functionality (19 tools × multiple scenarios)
• Skills system infrastructure
• File provisioning
• MCP protocol compliance
• Error handling and edge cases

# Run all tests
dart test

# Run specific test suite
dart test test/tools/tools_integration_test.dart

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.

Credits

• Inspired by Laravel Boost
• Built for ServerPod
• Uses MCP Protocol

Roadmap

• Web UI for skill management
• Skill marketplace
• Visual workflow builder
• Integration with other AI assistants
• Performance monitoring and analytics

---

Made with ❤️ for the ServerPod community

Version: 0.1.6 | Tests: 400+ | Tools: 19 | Skills: 8 built-in categories