mcp-orchestro

Orchestro acts as an AI-driven development conductor that bridges product management, development work, and Claude Code sessions. It provides a real-time dashboard, task decomposition, dependency tracking, and learning from past successes and failures. The MCP server exposes a toolset to decompose user stories into technical tasks, visualize progress on a Kanban-like board, and maintain context across sessions. With the included MCP tools, you can manage dependencies between tasks, generate implementation guidance, and export reports for stakeholders. To get started, install Orchestro via NPX and configure the database connection string, then run the server through your MCP configuration. The setup enables the dashboard, migrations, and automatic Claude Code integration so you can orchestrate development workflows end-to-end.

Prerequisites

• Node.js 18+ installed on your machine
• Access to a Supabase project (or another compatible database) with a connection string

Step-by-step installation

1. Ensure Node.js is installed

node --version

2. Install Orchestro via NPX (recommended, no global install)

npx @khaoss85/orchestro@latest

3. Provide database connection details

• Obtain your Supabase connection string from Settings → Database → Connection String (Transaction mode)
• Or set the environment variable before starting: export DATABASE_URL="your-supabase-connection-string"

4. Configure Claude Code (auto-configure recommended)

npm run configure-claude

5. Start using Orchestro through the MCP config (see mcp_config above) by initiating the MCP server in your environment. The setup will provision migrations and start the dashboard automatically when the workflow runs.

Optionally, for a manual install workflow:

• Clone the repository and install dependencies

git clone https://github.com/khaoss85/mcp-orchestro.git
cd mcp-orchestro
npm install

• Apply migrations to your Supabase database (as described in the README) and configure Claude Code as shown in the Quick Start guide.

Tips and/common issues:

• Ensure the DATABASE_URL is accessible from the environment where you run Orchestro; network access must be allowed to your Supabase instance.
• If you upgrade the MCP server, use the latest tag to pull new features and migrations.
• The MCP server relies on real-time updates via Socket.io for dashboards; verify network connectivity if you don’t see live updates.
• Use the provided quick setup options to seed initial configurations and migrations automatically.
• When configuring Claude Code, rely on the auto-configure script first, then adjust settings manually if needed.
• Keep your credentials secure; never commit database keys to source control.