{"id":51201190,"url":"https://github.com/mordiaky/idea-lab-mcp","last_synced_at":"2026-06-28T00:30:53.308Z","repository":{"id":347607988,"uuid":"1194616920","full_name":"mordiaky/idea-lab-mcp","owner":"mordiaky","description":"MCP server for structured ideation — generating, scoring, and storing software ideas","archived":false,"fork":false,"pushed_at":"2026-03-28T17:59:20.000Z","size":125,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-28T18:23:26.615Z","etag":null,"topics":["idea-generation","ideation","mcp","mcp-server","model-context-protocol","software-ideas","sqlite","typescript"],"latest_commit_sha":null,"homepage":"https://mordiaky.github.io/idea-lab-mcp/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mordiaky.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-28T15:44:22.000Z","updated_at":"2026-03-28T17:59:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mordiaky/idea-lab-mcp","commit_stats":null,"previous_names":["mordiaky/idea-lab-mcp"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/mordiaky/idea-lab-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mordiaky%2Fidea-lab-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mordiaky%2Fidea-lab-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mordiaky%2Fidea-lab-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mordiaky%2Fidea-lab-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mordiaky","download_url":"https://codeload.github.com/mordiaky/idea-lab-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mordiaky%2Fidea-lab-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34873663,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["idea-generation","ideation","mcp","mcp-server","model-context-protocol","software-ideas","sqlite","typescript"],"created_at":"2026-06-28T00:30:53.215Z","updated_at":"2026-06-28T00:30:53.300Z","avatar_url":"https://github.com/mordiaky.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Idea Lab\n\n[![npm version](https://img.shields.io/npm/v/idea-lab-mcp)](https://www.npmjs.com/package/idea-lab-mcp)\n[![GitHub release](https://img.shields.io/github/v/release/mordiaky/idea-lab-mcp)](https://github.com/mordiaky/idea-lab-mcp/releases)\n[![License: PolyForm Noncommercial](https://img.shields.io/badge/license-PolyForm--Noncommercial-blue)](LICENSE)\n\nAn MCP server that turns your AI assistant into a structured ideation partner. It generates, scores, critiques, and stores software ideas locally — so your assistant remembers past ideas across sessions and never suggests the same thing twice.\n\nIncludes a **built-in web dashboard** with a Kanban board, lineage graph, and portfolio view — with dark and light mode support.\n\n## What it does\n\nYou talk to your AI assistant like normal. Idea Lab gives it tools to:\n\n**Generate ideas** using 4 different creative techniques, then run each one through a pipeline:\n\n```\n\"Generate 5 software ideas in the developer tools space\"\n\n  idea_lab_generate_ideas  →  generates candidates\n  idea_lab_save_idea       →  stores each one\n  idea_lab_score_idea      →  scores on 7 dimensions\n  idea_lab_critique_idea   →  tries to tear it apart\n  idea_lab_check_duplicate →  checks against everything stored\n```\n\n**Search and revisit** ideas you've generated before:\n\n```\n\"Show me my highest-rated ideas\"\n\"Find ideas related to automation\"\n\"What shortlisted ideas haven't I looked at in a while?\"\n```\n\n**Evolve ideas** that survived the pipeline:\n\n```\n\"Take that CLI tool idea and reimagine it as a SaaS product\"\n\"Create an MVP plan for my top-rated idea\"\n```\n\nEverything is stored locally in SQLite. No cloud, no API keys, no data leaving your machine.\n\n## Web Dashboard\n\nThe MCP server includes a built-in web dashboard that starts automatically at `http://localhost:3001`. No separate process needed.\n\n- **Kanban Board** — drag-and-drop ideas between status columns\n- **Lineage Graph** — visualize how ideas connect through mutations\n- **Portfolio View** — heat map and table showing domain distribution and scores\n- **Detail Panel** — click any idea for its full breakdown (radar chart, critique flags, MVP steps, lineage)\n- **Dark / Light Mode** — toggle in the navbar, respects OS preference, persists across sessions\n\nUse the `idea_lab_open_dashboard` tool to open it in your browser, or just navigate to `http://localhost:3001` directly.\n\nFor the full guide, see [Web Dashboard Guide](docs/web-dashboard.md).\n\n## Install\n\n### From npm\n\n```bash\nnpm install idea-lab-mcp\ncd node_modules/idea-lab-mcp\nnode build/db/migrate.js\n```\n\n### From source\n\n```bash\ngit clone https://github.com/mordiaky/idea-lab-mcp.git\ncd idea-lab-mcp\nnpm install\nnpm run build        # compiles server + web dashboard\nnpm run db:migrate\n```\n\nRequires **Node.js 22+**. If `npm install` fails, see [platform setup](docs/platform-setup.md).\n\nOnce connected to your editor, the MCP server starts automatically and the web dashboard is available at `http://localhost:3001`.\n\n## Connect to your editor\n\nAdd the server to your MCP client. Replace `/absolute/path/to` with the real path to where you cloned the project.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eVS Code (GitHub Copilot)\u003c/b\u003e\u003c/summary\u003e\n\nCreate `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"idea-lab\": {\n      \"type\": \"stdio\",\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/idea-lab-mcp/build/index.js\"]\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCursor\u003c/b\u003e\u003c/summary\u003e\n\nCreate `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per-project):\n\n```json\n{\n  \"mcpServers\": {\n    \"idea-lab\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/idea-lab-mcp/build/index.js\"]\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWindsurf\u003c/b\u003e\u003c/summary\u003e\n\nEdit `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"idea-lab\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/idea-lab-mcp/build/index.js\"]\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eContinue (VS Code / JetBrains)\u003c/b\u003e\u003c/summary\u003e\n\nAdd to `~/.continue/config.yaml`:\n\n```yaml\nmcpServers:\n  - name: idea-lab\n    command: node\n    args:\n      - /absolute/path/to/idea-lab-mcp/build/index.js\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCline\u003c/b\u003e\u003c/summary\u003e\n\nUse the MCP Servers panel in Cline's UI, or edit the config directly:\n\n| OS | Path |\n|----|------|\n| macOS | `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |\n| Windows | `%APPDATA%\\Code\\User\\globalStorage\\saoudrizwan.claude-dev\\settings\\cline_mcp_settings.json` |\n| Linux | `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |\n\n```json\n{\n  \"mcpServers\": {\n    \"idea-lab\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/idea-lab-mcp/build/index.js\"]\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eClaude Desktop\u003c/b\u003e\u003c/summary\u003e\n\n| OS | Config path |\n|----|-------------|\n| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Windows | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| Linux | `~/.config/Claude/claude_desktop_config.json` |\n\n```json\n{\n  \"mcpServers\": {\n    \"idea-lab\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/idea-lab-mcp/build/index.js\"]\n    }\n  }\n}\n```\n\nFully quit and restart the app after editing.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eClaude Code (CLI)\u003c/b\u003e\u003c/summary\u003e\n\n```bash\nclaude mcp add idea-lab -- node /absolute/path/to/idea-lab-mcp/build/index.js\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eZed\u003c/b\u003e\u003c/summary\u003e\n\nAdd to `~/.config/zed/settings.json`:\n\n```json\n{\n  \"context_servers\": {\n    \"idea-lab\": {\n      \"source\": \"custom\",\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/idea-lab-mcp/build/index.js\"]\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n## Example workflows\n\n### Brainstorm session\n\n\u003e \"Generate software ideas for the healthcare space, then score and critique the best ones\"\n\nThe assistant will:\n1. Call `generate_ideas` to create 5-8 candidates using different creative techniques\n2. Save each one and score it across 7 dimensions (novelty, usefulness, feasibility, testability, speed to MVP, defensibility, clarity)\n3. Critique the high scorers — searching for existing products, fragile dependencies, and vague claims\n4. Check for duplicates against your stored ideas\n5. Return a summary of what passed and what got rejected\n\n### Build on a winner\n\n\u003e \"Show me my shortlisted ideas and create an MVP plan for the best one\"\n\nThe assistant will:\n1. Search your stored ideas filtered to `shortlisted` status\n2. Pick the highest-scoring one (or let you choose)\n3. Generate 3-5 concrete MVP steps with tech stack recommendations\n\n### Explore a different angle\n\n\u003e \"Take idea X and mutate it — what if we targeted enterprise users instead?\"\n\nThe assistant calls `mutate_idea` to create a variant that changes the target user while keeping the core concept. The variant is linked to the original so you can compare lineage.\n\n### Import ideas from your notes\n\n\u003e \"Here are my ideas from last month's brainstorm session: [paste messy notes]\"\n\nThe assistant calls `submit_idea` with your raw text, extracts each discrete idea, structures them, and runs each through the full scoring pipeline.\n\n### Strengthen a weak idea\n\n\u003e \"Idea X scored weak — refine it with a 'weekend-buildable' constraint\"\n\nThe assistant calls `refine_idea` to apply the constraint, generating a tighter version that gets re-scored. You can keep applying different constraints (CLI-only, offline-only, etc.) until it passes or you move on.\n\n### Break a big idea into shippable pieces\n\n\u003e \"Decompose my top idea into things I can actually start building\"\n\nThe assistant calls `decompose_idea` to split it into 3-7 independently shippable micro-products, each scored on its own. It recommends which piece to start with this weekend.\n\n### Revisit old ideas\n\n\u003e \"What shortlisted ideas have I not looked at in 2 weeks?\"\n\nThe assistant calls `resurface_ideas` to find stale shortlisted ideas that might deserve a second look now that your thinking has evolved.\n\n## How scoring works\n\nEach idea is scored 0-10 on 7 dimensions with different weights:\n\n| Dimension | Weight | What it measures |\n|-----------|--------|------------------|\n| Novelty | 25% | Is this genuinely new? |\n| Usefulness | 25% | Does it solve a real problem? |\n| Feasibility | 20% | Can it actually be built? |\n| Testability | 15% | Can you validate it works? |\n| Speed to MVP | 10% | How fast to a working prototype? |\n| Defensibility | 5% | Is it hard to copy? |\n| Clarity | gate | Is the idea well-defined? (min 5, not in composite) |\n\nIdeas need to clear minimum thresholds (feasibility \u003e= 7, usefulness \u003e= 7, novelty \u003e= 6, composite \u003e= 6.5) to advance.\n\n## How ideas move through the pipeline\n\n```\nraw  --\u003e  shortlisted  --\u003e  build-next\n |             |                |\n +---- rejected (terminal) ----+\n```\n\n- **raw** — just generated, not yet evaluated\n- **shortlisted** — passed scoring, critique, and dedup checks\n- **build-next** — picked for MVP planning\n- **rejected** — didn't survive evaluation (can happen at any stage)\n\n## Tools reference\n\n| Tool | What it does |\n|------|-------------|\n| `idea_lab_generate_ideas` | Generate 5-8 candidates using creative techniques |\n| `idea_lab_save_idea` | Store a new idea |\n| `idea_lab_score_idea` | Score on 7 dimensions |\n| `idea_lab_critique_idea` | Adversarial critique |\n| `idea_lab_check_duplicate` | Check for duplicates |\n| `idea_lab_search_ideas` | Search by status, domain, score, tags, date |\n| `idea_lab_get_recent_ideas` | Get last N ideas |\n| `idea_lab_promote_idea` | Advance through lifecycle |\n| `idea_lab_delete_idea` | Delete a rejected idea |\n| `idea_lab_mutate_idea` | Create a variant on a different axis |\n| `idea_lab_resurface_ideas` | Find stale shortlisted ideas |\n| `idea_lab_mark_revalidated` | Mark idea as re-reviewed |\n| `idea_lab_remove_pattern` | Remove a false-positive rejection pattern |\n| `idea_lab_generate_action_plan` | Create MVP steps for an idea |\n| `idea_lab_submit_idea` | Import unstructured notes and extract ideas |\n| `idea_lab_refine_idea` | Strengthen a weak idea through constraints |\n| `idea_lab_decompose_idea` | Break a big idea into shippable micro-products |\n| `idea_lab_open_dashboard` | Open the web dashboard in your browser |\n\n## Configuration\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `IDEA_LAB_DB` | `~/.idea-lab/ideas.db` | SQLite database location |\n| `IDEA_LAB_WEB_PORT` | `3001` | Port for the web dashboard |\n\nBoth settings are optional. The defaults work without any configuration.\n\n## Development\n\n```bash\nnpm run dev           # Run MCP server (no build step, serves built dashboard)\nnpm run build         # Compile TypeScript server + React dashboard\nnpm test              # Run tests\nnpm run db:generate   # Generate migrations from schema changes\nnpm run db:migrate    # Apply migrations\nnpm run db:seed       # Load sample data\n```\n\nFor dashboard frontend development with hot reload:\n\n```bash\ncd web \u0026\u0026 npm run dev  # Vite dev server, proxies API to port 3001\n```\n\n## Part of Thinking Tools\n\nIdea Lab is also bundled in [Thinking Tools MCP](https://github.com/mordiaky/thinking-tools) — a unified suite with 61 tools across 8 modules (including Hypothesis Tracker, Decision Matrix, Mental Models, and more). Use this standalone version if you only need ideation.\n\n## License\n\n[PolyForm Noncommercial 1.0.0](LICENSE) — free for personal and non-commercial use.\n\nFor commercial licensing, contact the author.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmordiaky%2Fidea-lab-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmordiaky%2Fidea-lab-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmordiaky%2Fidea-lab-mcp/lists"}