aistarter-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@aistarter-mcp I want to build a habit tracker — walk me through the workflow"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AiStarterMCP — Senior Dev in a Box
An MCP server that acts as a senior-developer mentor for people just starting out with AI coding tools (Claude Code, Codex, Cursor, opencode, etc). Instead of jumping straight into code, it walks the human through a structured process before anything gets built:
Classify — experience level, then which AI tool they're using.
Interview — one question at a time about the project idea.
Scope → Architecture → Database schema → Roadmap — each stage gives a draft suggestion first, then locks in the human-confirmed decision before moving on.
The server enforces the order and remembers every decision (so a long project doesn't suffer from context amnesia). The actual reasoning — turning answers into a scope, picking a stack, designing a schema — is done by the calling AI agent together with the human; the server's heuristics are just a starting draft to react to.
Install & register
Published on npm as aistarter-mcp — no clone or build needed, just Node.js. npx downloads and runs it on the fly.
Register with Claude Code:
claude mcp add aistarter -- npx -y aistarter-mcpRegister with Codex CLI (add to ~/.codex/config.toml):
[mcp_servers.aistarter]
command = "npx"
args = ["-y", "aistarter-mcp"]Register with Cursor (.cursor/mcp.json or global MCP settings):
{
"mcpServers": {
"aistarter": { "command": "npx", "args": ["-y", "aistarter-mcp"] }
}
}Register with opencode (opencode.json, project-level or ~/.config/opencode/opencode.json for global):
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"aistarter": {
"type": "local",
"command": ["npx", "-y", "aistarter-mcp"],
"enabled": true
}
}
}Building from source instead
git clone <this repo>
cd aistarter-mcp
npm install
npm run build
claude mcp add aistarter -- node "/absolute/path/to/aistarter-mcp/dist/index.js"Related MCP server: CodeCrafted Design MCP
Tools
Tool | Purpose |
| Classify the user (experience level + AI tool) and get the first interview question. |
| Submit an answer, get the next question. |
| Inspect a session's full state at any point. |
| Find a session again without remembering its id. |
| Draft/finalize the project scope. |
| Draft/finalize the tech stack. |
| Draft/finalize a baseline schema + security notes. |
| Draft/finalize a sprint-by-sprint roadmap. |
| Write |
| Compare a project's actual |
Each pipeline tool (scope/architecture/schema/roadmap) works the same way: call it without finalize to get a heuristic draft, review/adjust it with the human, then call it again with finalize: true and the corrected data to lock it in and move to the next stage. Calling a stage before the previous one is finalized returns a clear error instead of silently proceeding.
Session data is stored locally at ~/.aistarter-mcp/sessions/<id>.json.
Starting to implement
Once a session's roadmap is finalized (stage: "done"), call scaffold_project_docs with the session id and the folder you're about to build the project in. It writes four files there:
PROJECT.md — the plan: one-liner, scope, architecture, data model. Reference material, not meant to be edited during implementation.
ENVIRONMENT.md — the chosen stack plus a setup checklist (heuristically derived from the architecture text) and a table to fill in as env vars get added.
PROGRESS.md — the roadmap's sprints as a checkbox list. This is the file to check items off in as work actually happens.
BUGS_AND_FIXES.md — an empty log, ready to append real bugs (symptom/root cause/fix) to as they come up.
By default it won't overwrite any of these 4 files if they already exist in target_dir (pass overwrite: true to force it) — so re-running it after you've started editing PROGRESS.md by hand is safe.
Staying on track while implementing
Call check_drift (same session_id + target_dir) any time during implementation — not just once. It reads PROGRESS.md and package.json from target_dir and flags:
A library installed that contradicts the scope (e.g. a payment SDK when scope said no payments needed) — possible scope creep.
A piece of the planned architecture that isn't in
package.jsonyet — informational if you just haven't gotten there, worth a second look if you have.A
must_have_featurefrom scope that doesn't appear to be covered by any roadmap sprint inPROGRESS.md.
Like the pipeline tools' drafts, these are heuristic signals to react to, not verdicts — review each finding rather than trusting it blindly.
Viewing your sessions (UI)
A small local, read-only web viewer lists every session you've interviewed through and lets you drill into one to see the full interview, scope, architecture, schema, and roadmap:
npx -y aistarter-mcp-uiOpens http://127.0.0.1:4870 (binds to localhost only) and tries to launch your browser automatically. Override the port with UI_PORT=4871 npx -y aistarter-mcp-ui. (Building from source: npm run ui instead.)
The UI is available in English, Thai, Chinese, Japanese, Indonesian, Vietnamese, and Russian — it auto-detects your browser's language on first visit, and there's a language switcher at the top of the page (persisted via cookie). Note this only translates the UI's own labels/headings; your actual interview answers, scope, architecture, etc. are shown exactly as you entered them, in whatever language that was.
Available Tools
10 toolsanswer_questionSubmit an interview answerA
Record the human's answer to the current interview question and get the next one. Once all questions are answered, the session moves to the scoping stage.
Inputs: answer (required), session_id (required), question_id (required).
check_driftCheck drift from the planA
Compare a project's actual state (PROGRESS.md checkboxes and package.json dependencies in target_dir) against the finalized scope and architecture from a session. Flags installed libraries that contradict the scope (e.g. a payment library when scope said no payments), stack pieces from the architecture that aren't installed yet, and planned features that don't appear in any roadmap sprint. Call this periodically during implementation, not just once at the start.
Inputs: session_id (required), target_dir (required).
evaluate_project_scopeEvaluate project scopeA
Draft or finalize the project's scope. Without finalize, returns a heuristic guess at the scope from the interview answers. With finalize: true and data, stores the human-confirmed scope and advances the session.
Inputs: session_id (required), data, finalize.
generate_database_schemaGenerate database schemaA
Draft or finalize a baseline database schema. Without finalize, returns starter collections/tables and a security-rules note picked from the scope. With finalize: true and data, stores the schema.
Inputs: session_id (required), data, finalize.
generate_roadmapGenerate roadmapA
Draft or finalize a sprint-by-sprint roadmap. Without finalize, returns a sprint breakdown sized to the feature set and experience level. With finalize: true and data, stores the roadmap and completes the session.
Inputs: session_id (required), data, finalize.
get_sessionGet session detailsB
Fetch the full state of a session: classification, interview answers, and any decisions made so far.
Inputs: session_id (required).
list_sessionsList sessionsA
List every saved session (most recently updated first), so a session can be found again without remembering its id.
Inputs: no named parameters.
propose_architecturePropose architectureA
Draft or finalize the tech stack. Without finalize, returns a rule-based suggestion (frontend/backend/database/hosting + rationale) based on the finalized scope and the human's experience level. With finalize: true and data, stores the chosen stack.
Inputs: session_id (required), data, finalize.
scaffold_project_docsScaffold project tracking docsA
Write PROJECT.md, ENVIRONMENT.md, PROGRESS.md, and BUGS_AND_FIXES.md into a target project directory, filled in from a finished session's scope/architecture/schema/roadmap. Call this once, right after generate_roadmap finalizes, at the point where the human is about to start actually implementing the project.
Inputs: session_id (required), target_dir (required), overwrite.
start_sessionStart a Senior Dev in a Box sessionA
Begin a new guided project session. Classifies the user (experience level, then which AI coding tool they're using) and returns the first interview question. Call this before anything else.
Inputs: ai_tool (required), experience_level (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool maps to a distinct step or artifact in the guided project workflow: session lifecycle, interview, scope, architecture, schema, roadmap, docs, and drift checking. The draft/finalize pattern repeats across four tools but each targets a different deliverable, so there is no real confusion.
Tool names consistently follow a verb_noun pattern: start_session, answer_question, get_session, list_sessions, evaluate_project_scope, propose_architecture, generate_database_schema, generate_roadmap, scaffold_project_docs, check_drift. The two generate_ tools are parallel and unsurprising given they both produce artifacts.
Ten tools is well-scoped for the guided project workflow the server covers. Each tool earns its place in the pipeline, and there is no obvious redundancy or bloat.
The server covers the full journey from initial classification through interview, scope, architecture, schema, roadmap, documentation scaffolding, and ongoing drift checking. The only notable gaps are lifecycle management conveniences like deleting or restarting a session, and there is no explicit tool for revising finalized artifacts after the session completes.
Maintenance
Related MCP Connectors
Adaptive plan/build/review cycles for AI coding assistants, persisted across sessions.
Generate architecture docs, implementation plans, and dev tickets from your project requirements.
Turn PRDs and product ideas into structured specs so coding agents build your intent, not theirs.
Turn a typed idea into a PRD, research, brand kit, tech design, roadmap and a Jira board.
Related MCP Servers
- AlicenseAqualityCmaintenancePrevents premature AI coding by transforming vague product ideas into structured specifications, architecture decisions, and acceptance criteria through a series of interrogation and compilation tools.723 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables AI coding agents to plan, build, and review websites and product interfaces with a persistent, user-led process, including design direction, component contracts, and implementation review.-
- AlicenseNot gradedqualityBmaintenanceServes instructions and templates that make any AI coding tool plan before building, work through a project checklist in the right order, and hold a consistent standard, while all reading and writing of your code stays on your machine.MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to research, plan, generate requirements, map codebases, curate context, manage tasks, scaffold projects, and run multi-step software development workflows.42 npmMIT