Back to Dashboard

Dev Workflow MCP Server

An MCP server that acts as your coding conscience. Enforce test-driven development, ensure documentation, and never skip a step in your release process.

Version: 1.8.1

Features

Enforced Discipline

Won't let you skip important steps. Follows a strict, proven development workflow.

Test-Driven

Blocks commits if tests fail. Encourages writing tests before marking tasks complete.

Documentation

Reminds you to update documentation (README, docs, changelog) for every change.

State Tracking

Remembers exactly where you are in the workflow, even across sessions.

Installation

npm install -g @programinglive/dev-workflow-mcp-server

Quick Start

  1. 1

    Start a Task

    Begin your coding session by defining what you're working on.

    start_task
  2. 2

    Mark Bug Fixed

    Once you've implemented your feature or fix, mark it as complete.

    mark_bug_fixed
  3. 3

    Create Tests

    Write tests to verify your changes work correctly.

    create_tests
  4. 4

    Run Tests

    Execute your test suite and ensure everything passes.

    run_tests
  5. 5

    Create Documentation

    Update relevant documentation for your changes.

    create_documentation
  6. 6

    Commit and Push

    Commit your changes and push to the repository.

    commit_and_push

Available Commands

start_task

Begin a new coding task

mark_bug_fixed

Mark feature/bugfix as complete

create_tests

Record that tests have been created

run_tests

Execute and record test results

skip_tests

Skip tests with justification

create_documentation

Record documentation updates

commit_and_push

Commit and push changes

perform_release

Execute release process

complete_task

Mark task as complete

get_workflow_status

Check current workflow state

view_history

View completed tasks

Configuration

The server stores workflow state in a SQLite database located at .state/dev-workflow.db

Set the DEV_WORKFLOW_USER_ID environment variable to isolate workflow state per user.

Requirements

  • Node.js 18 or higher
  • Git installed and configured
  • MCP-compatible AI assistant (e.g., Claude Desktop)

License

MIT License - Free to use for personal and commercial projects.

Ready to get started?

Install the MCP server and start enforcing best practices in your development workflow today!

View on GitHub