What is Project Handoffs

Project-handoffs is an MCP tool designed to facilitate the management of AI session handoffs and track subsequent steps in project workflows.

Use cases

Use cases include managing AI coding agent sessions, tracking project progress through defined next steps, and ensuring smooth transitions between different phases of project development.

How to use

To use project-handoffs, install the necessary dependencies using npm, configure the MCP server settings, and utilize available tools such as creating projects, next steps, and handoffs to manage your AI sessions effectively.

Key features

Key features include project-based organization, priority levels for implementation impact, tools for listing templates, creating projects and next steps, starting working sessions, and tracking handoff histories.

Where to use

Project-handoffs can be used in software development environments, AI project management, and any scenario requiring structured tracking of tasks and session transitions.

Project Handoffs MCP Server

MCP server for managing AI session handoffs and next steps tracking.

Core Concepts

• NextStep → WorkingSession → Handoff → New NextStep chains
• Project-based organization
• Priority levels mapped to implementation impact:
  • core-critical: Critical for working implementation
  • full-required: Necessary for desired implementation
  • enhancement: Improvements and optimizations

Available Tools

• list_templates - List available templates for next steps, working sessions, and handoffs
• create_project - Create a new project for tracking AI session handoffs
• delete_project - Delete a project and all its data
• create_next_step - Create a new next step in a project
• start_working_session - Start working on a next step
• create_handoff - Complete a working session with handoff details
• get_latest_next_steps - Get open next steps ordered by priority
• get_next_step_history - Get complete history of a next step including session and handoff

Installation

npm install
npm run build

Configuration

Add to your MCP configuration:

{
  "mcpServers": {
    "project-handoffs": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "/path/to/project-handoffs/build/index.js"
      ],
      "alwaysAllow": []
    }
  }
}

Project Structure

project-handoffs/
├── src/
│   ├── index.ts           # Server implementation
│   ├── templates.ts       # Entity templates
│   ├── types.ts          # TypeScript types
│   └── errors.ts         # Error handling
├── package.json          
└── README.md

Development

# Install dependencies
npm install

# Development mode
npm run dev

# Build
npm run build


## Implementation Details

- Error handling through ProjectError class
- Template validation for all entity types
- Consistent state management
- Safe data persistence with proper error handling
- Type-safe implementation following project-memory-server patterns

## Security

If you discover a security vulnerability, please create a new issue with the label 'security'. We take all security reports seriously and will respond promptly.

## Contributing

Contributions are welcome. Feel free to submit a Pull Request.

## License

This project is licensed under the Apache License 2.0 - see the [LICENSE](https://raw.githubusercontent.com/davidorex/project-handoffs/master/LICENSE) file for details.