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.3 - MCP Path Option

ServerPod Boost now supports running from any directory with the --path option, making it easier to use when your .mcp.json is in your project root but your ServerPod server is in a subdirectory.

Version 0.1.2 - Published Package Fix

This is the first public release of ServerPod Boost, providing the core infrastructure for AI-assisted ServerPod development. The skills system framework is in place, with pre-built skills coming in future releases.

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
Skills Infrastructure: Framework for extensible workflows (pre-built skills coming soon)

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"
"Use the endpoint_creator skill to add a user profile endpoint"

Features

20 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 available skills
`get_skill`	Get skill content
`log_reader`	Read ServerPod logs
`database_query`	Query database
`cli_commands`	List CLI commands
`tinker`	Execute Dart code

Skills Infrastructure

ServerPod Boost includes the infrastructure for an extensible skills system. The framework is in place for creating and managing reusable workflows that combine multiple tools. Pre-built skills will be available in future releases.

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) - 20개 MCP 도구 상세 문서
스킬 개발 가이드 (Skills Development Guide) - 커스텀 스킬 만들기
AGENTS.md - AI 에이전트를 위한 프로젝트 문서

Testing

Boost includes 400+ tests covering:

Tool functionality (20 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.3 | Tests: 400+ | Tools: 20

Libraries

agents/agent
agents/agent_detector: Agent Detector
agents/agents: Agent abstraction barrel file
agents/claude_code_agent
agents/opencode_agent
boost: ServerPod Boost - Main library entry point
boost_exception: ServerPod Boost exceptions
cli/cli_app: CLI Application
cli/command: Base command interface
cli/console
cli/console_helper: Console helper utilities
cli/spinner
commands/install_command: install command
commands/skill_add_command: skill:add command
commands/skill_list_command: skill:list command
commands/skill_remove_command: skill:remove command
commands/skill_render_command: skill:render command
commands/skill_show_command: skill:show command
guidelines/agent_type: Agent types for guideline generation
guidelines/guideline_composer: Guideline composer
guidelines/guideline_writer: Guideline writer for ServerPod Boost
guidelines/guidelines: Guidelines package
install/install_utils: Installation utilities
mcp/boost_mcp_server
mcp/mcp_logger: MCP Logger
mcp/mcp_prompt: MCP Prompt interface
mcp/mcp_protocol: MCP Protocol implementation based on JSON-RPC 2.0
mcp/mcp_request: MCP Request - Request types and validation
mcp/mcp_resource: MCP Resource interface
mcp/mcp_response: MCP Response - Response types and builders
mcp/mcp_server: MCP Server - Main server implementation
mcp/mcp_tool: MCP Tool interface and base implementations
mcp/mcp_tool_adapter
mcp/mcp_transport: MCP Transport layer for stdio communication
project_context: Project context for template rendering
serverpod/method_parser: Parser for ServerPod endpoint method signatures
serverpod/project_root
serverpod/serverpod_locator: ServerPod Service Locator
serverpod/spy_yaml_parser: Parser for ServerPod .spy.yaml model definition files
skills/github_skill_fetcher: GitHub skill fetcher
skills/skill: A ServerPod Boost skill
skills/skill_composer: Skill composer
skills/skill_conflict_resolver
skills/skill_loader: Skill loader
skills/skill_metadata: Metadata for a skill
skills/template_renderer: Template renderer for skills
tool_registry: Tool Registry - Manual registration approach
tools/application_info_tool: Application Info Tool
tools/call_endpoint_tool: Call Endpoint Tool
tools/cli_commands_tool: CLI Commands Tool
tools/config_reader_tool: Config Reader Tool
tools/database_query_tool: Database Query Tool
tools/database_schema_tool: Database Schema Tool
tools/endpoint_methods_tool: Endpoint Methods Tool
tools/find_files_tool: Find Files Tool
tools/get_skill_tool: Get Skill Tool
tools/list_endpoints_tool: List Endpoints Tool
tools/list_models_tool: List Models Tool
tools/list_skills_tool: List Skills Tool
tools/log_reader_tool: Log Reader Tool
tools/migration_scanner_tool: Migration Scanner Tool
tools/model_inspector_tool: Model Inspector Tool
tools/project_structure_tool: Project Structure Tool
tools/read_file_tool: Read File Tool
tools/search_code_tool: Search Code Tool
tools/service_config_tool: Service Config Tool
tools/tinker_tool: Dart Tinker Tool
tools/tools: Barrel file for all MCP tools