Project Manager — Laravel MCP Server

A small project & task manager exposed as a Model Context Protocol (MCP) server, built with laravel/mcp. It is a learning-oriented reference that exercises every core MCP primitive — Tools, Resources, and Prompts — over a deliberately simple domain (projects that contain tasks).

An MCP client (Claude Desktop, Cursor, Claude Code, or the built-in inspector) connects to the server over stdio and lets an AI create and track tasks, pull read-only context, and run reusable prompt templates.

Domain

• Project — name, description, and many tasks.

• Task — belongs to a project; has a title, description, due_date, a status (pending, in_progress, done) and a priority (low, medium, high, critical). A task is overdue when its due date has passed and it is not yet done.

Priorities carry a numeric weight (low = 1 … critical = 4) used to sort reports and triage overdue work.

Related MCP server: Project Management AI MCP

Project structure

app/
├── Enums/          TaskStatus, TaskPriority (with label() / weight() helpers)
├── Models/         Project, Task
├── Mcp/
│   ├── Servers/    ProjectManagerServer — registers all primitives
│   ├── Tools/      The 5 callable actions
│   ├── Resources/  The 5 read-only resources
│   └── Prompts/    The 4 prompt templates
└── Support/        ReportBuilder — shared report aggregation

MCP primitives

🔧 Tools — actions the AI can invoke

📚 Resources — read-only context addressed by URI

The report tool and the report resource share a single ReportBuilder so their numbers can never drift apart.

💬 Prompts — reusable, argument-driven templates

Getting started

composer install
php artisan migrate

# Seed at least one project so tasks have somewhere to live:
php artisan tinker --execute "App\Models\Project::factory()->create(['name' => 'Website Redesign']);"

The server is registered in routes/ai.php and exposed over stdio:

Mcp::local('project-manager', ProjectManagerServer::class);

Running & testing the server

# Interactive debugging — drive tools, resources and prompts by hand:
php artisan mcp:inspector project-manager

# Run the server over stdio (this is the command MCP clients launch;
# on its own it will appear to hang, waiting for JSON-RPC on stdin):
php artisan mcp:start project-manager

Connecting from an AI client

Claude Code

claude mcp add project-manager -- php "<full-path>/artisan" mcp:start project-manager

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "project-manager": {
      "command": "php",
      "args": ["<full-path>/artisan", "mcp:start", "project-manager"]
    }
  }
}

Passing the full path to artisan lets Laravel resolve the project root regardless of the client's working directory.