Feedbacks MCP server

Feedbacks

Free, Apache-2.0 visual feedback, session replay and debugging context.

Show the problem with a screenshot, exact text suggestion or video + session recording. Keep the discussion, event timeline, browser diagnostics and approved project context together. Your team and coding agent can investigate the evidence, make the agreed change and record verification. The complete product is free to self-host; you provide the infrastructure and any AI tools you use.

Set up a team server first. The order is: server → install and connect the Chrome extension → project context, optional GitHub App and members → each developer's personal MCP setup. One installation serves your team; the extension does not host a server. Follow the complete setup flow, or the separate DevOps installation guide.

Website · Why Feedbacks · Self-hosting · Extension · Coding assistants & plugins · API & MCP · Roadmap · Contributing

What it does

• Show exactly what changed: screenshot pins, annotation, full-page capture and selected-text replacement suggestions.
• Replay the bug: video or session-only recording with one timeline for activity, console, network and performance. Save and annotate frames.
• Take the evidence: complete thread bundles with discussion, media, recordings, diagnostics and checksums; scoped agent reads and recording exports.
• Give agents context: approved project instructions, reviewer guidance and responsibilities through MCP, API and CLI.
• Move the work forward: assignments, categories, tags, saved views and point progress; optional GitHub Issues across repositories and installations, with multiple configured Apps and one owner-selected App per project.
• Review beyond the extension: scoped guest links, PDF/image review, an optional text widget, surveys/NPS, scheduled public-page QA, native mobile clients and signed webhooks.
• Own the whole service: Apache-2.0 server and clients, PostgreSQL and private S3-compatible storage. One installation serves one organization.

Recording guide · Debug bundles · Text suggestions · More review workflows

Feedbacks is an early 0.x release. Each application deployment serves one organization. Public registration, billing, SSO and shared-database customer tenancy are not implemented. See architecture and deployment boundaries.

Run locally

Requirements: Node.js 22 or 24, npm, and Docker Compose for PostgreSQL.

git clone https://github.com/Softinator-TechLabs/feedbacks-oss.git
cd feedbacks-oss
npm ci
cp .env.example .env
docker compose -f compose.dev.yaml up -d --wait
npm run bootstrap
npm run build
npm run dev:server

Before bootstrap, add BOOTSTRAPEMAIL, BOOTSTRAPNAME and a unique BOOTSTRAP_PASSWORD to your local .env. Bootstrap creates the first owner once. Remove the bootstrap password afterward. Open localhost:3000. The example database password is for the loopback-only development database.

For live client edits, run npm run dev:web in another terminal and set APP_ORIGIN=http://localhost:5173 in .env before restarting the server. Use that origin in the browser. For the standalone public website, use npm run dev:site.

Production requires HTTPS, PostgreSQL and private S3-compatible storage. Follow the deployment guide for configuration, first-owner setup and recovery.

Shortened. The full README is on GitHub.