Agentic Software Factory MCP

Turn Cursor into a full software factory.

10 specialist agents (PM, Architect, Backend, Frontend, Database, AI, Security, QA, DevOps, Code Reviewer) as a local MCP server.

Your code stays on your machine.

p.s. If this saves you time, star the repo - it helps others find it.

Why this exists

AI coding tools are powerful, but they often answer as a generic assistant.

This MCP gives you a role-based factory inside Cursor (or Claude Desktop): PM, Architect, Backend, Frontend, Database, AI, Security, QA, DevOps, and Code Reviewer - all local, via Docker or Python.

Related MCP server: Claude Team MCP

Install in 3 minutes

Docker (recommended)

git clone https://github.com/tresor228/agentic-software-factory-mcp.git
cd agentic-software-factory-mcp
./scripts/install-docker.sh

Windows PowerShell:

.\scripts\install-docker.ps1

1. Paste the printed JSON into Cursor → Settings → MCP

2. Restart Cursor

3. Confirm the server is green: agentic-software-factory → 7 tools, 10 prompts, 4 resources

Works on Linux, macOS, and Windows (Docker Desktop).

./scripts/install.sh      # Python 3.11+
./scripts/install-uv.sh   # no system Python

See docs/installation.md.

How to use the agents

Important: in Cursor, agents are MCP prompts, not @mentions.

@ usually lists files/docs. Your agents appear in the MCP prompts menu or via / (depends on Cursor version).

Example flow:

1. Prompt: software_architect
   Task: Analyze this repo and propose a scalable architecture.

2. Prompt: database_architect
   Task: Design the schema from existing models.

3. Prompt: code_reviewer
   Task: Review the latest implementation for bugs and security.

Full guide: docs/usage.md · Agent list: AGENTS.md

What's inside

Tools: filesystem (read/list/search) · GitHub (public without token)
Knowledge: coding, architecture, security, database rules as MCP resources
Config: none required to start

Security (read this)

• Default mount is ~/Projects when it exists; otherwise home (with a warning).

• Prefer mounting a projects folder, not your full home (.ssh, .aws, …).

• Never paste a GitHub PAT in chat. Use GITHUB_TOKEN in the MCP process env only if you need private repos.

Project layout

src/server.py      MCP entrypoint (stdio)
src/agents/        10 role prompts
src/tools/         filesystem + GitHub
src/knowledge/     shared rules (resources)
scripts/           Docker / Python / uv installers
docs/              installation + usage

Star, fork, contribute

If you use this daily:

1. Star the repo so more builders find it

2. Open issues for bugs / ideas

3. PRs welcome - see CONTRIBUTING.md

Built for the open-source MCP ecosystem. MIT licensed.

Roadmap

License

MIT © TresorAlad