awesome-mcp-dev-stack-selector

Machine-Readable Free & Open-Source Software (FOSS) Registry & Zero-Latency MCP Server for AI Coding Agents

---

🚀 Executive Summary & Value Proposition

Traditional "Awesome" markdown lists on GitHub are static text documents: they suffer from dead links, unverified command lines, lack of machine readability, and zero contextual utility inside modern AI coding workflows.

awesome-mcp-dev-stack-selector bridges crowd-sourced community curation with AI developer tooling by providing an interactive Model Context Protocol (MCP) server and live catalog web application.

🌟 Key Value Highlights

• ⚡ 0ms Zero-Latency Cold Start: Starts instantly in 0ms using a Tier-1 NPM package bundled snapshot, backed by local disk caching and non-blocking background ETag sync.
• 🤖 AI-Agent Context Native: Allows Antigravity, Cursor, Claude Desktop, VS Code, and Windsurf to query tools, read resources, and execute workflow prompts directly inside agent loops.
• 🛡️ Supply-Chain Command Sanitization: All community PRs undergo strict Regex validation in CI to eliminate malicious shell command injection risks (brew install, winget install).
• 🔍 BM25 & Capability Search: In-memory relevance engine capable of matching natural language query intents like "offline vector editor capable of SVG export".
• 🔄 FOSS Commercial Replacement Mapping: Instant mapping from proprietary commercial software (Postman, Notion, Photoshop, Docker Desktop, Firebase) to verified open-source alternatives.

---

🌐 Live Web Application & Catalog

Experience the interactive web app hosted on GitHub Pages: awesome-mcp-dev-stack-selector.github.io

• 🔍 Live Real-time Filtering: Filter by category, operating system (macOS, Windows, Linux), capabilities, and 100% offline usability.
• 🔄 Interactive Commercial Replacement Finder: Instant search for proprietary software replacements.
• ⚡ MCP Tool Execution Playground: Interactive browser simulator for testing MCP stdio tool payloads in real-time!

---

⚡ Agent Setup & Configuration

Add the MCP server to your AI coding environment zero-install using npx:

1. Antigravity & Claude Desktop

Add to claude_desktop_config.json or Antigravity MCP Settings:

{
  "mcpServers": {
    "dev-stack-selector": {
      "command": "npx",
      "args": ["-y", "@awesome-mcp-dev-stack-selector/mcp-server"]
    }
  }
}

2. Cursor IDE

Go to Settings ➔ Features ➔ MCP and add a new MCP Server:

• Name: dev-stack-selector
• Type: command
• Command: npx -y @awesome-mcp-dev-stack-selector/mcp-server

3. VS Code / Windsurf

Add to your workspace .mcp.json:

{
  "mcpServers": {
    "dev-stack-selector": {
      "command": "npx",
      "args": ["-y", "@awesome-mcp-dev-stack-selector/mcp-server"]
    }
  }
}

---

🛠️ Complete MCP Interface Specification

awesome-mcp-dev-stack-selector implements the full Model Context Protocol (MCP) specification across Tools, Resources, and Prompts:

sequenceDiagram
    autonumber
    actor Agent as AI Coding Agent (Antigravity / Cursor)
    participant MCP as MCP Server (@awesome-mcp-dev-stack-selector)
    participant Cache as 3-Tier Hybrid Cache
    participant Engine as BM25 Search Engine

    Agent->>MCP: Call tool find_foss_alternative(paid_software: "postman")
    MCP->>Cache: Get active registry snapshot
    Cache-->>MCP: Returns 9 validated app entries
    MCP->>Engine: Match replacement targets for "postman"
    Engine-->>MCP: Match found: Bruno (Score 10.0, Seamless migration)
    MCP-->>Agent: Returns relevance-scored JSON card with brew/winget install commands

1. MCP Tools Surface (Executable Functions)

🔹 search_free_apps

Search free/FOSS software using natural language keywords, category, platform, or capability flags.

• Parameters:

  • query (string, optional): Keyword, app name, or capability (e.g. offline-editing, local-llm).
  • platform (string, optional): macOS | Windows | Linux
  • category (string, optional): developer-tools | ai-tools | container-infra | design-media | productivity
  • capability (string, optional): Specific capability requirement (e.g. git-versioning).
  • offline_only (boolean, optional): Filter for apps usable 100% offline.

• Example Payload:

{
  "total_found": 1,
  "apps": [
    {
      "id": "bruno",
      "name": "Bruno",
      "tagline": "Fast, offline-first, Git-friendly open-source API client",
      "license": "MIT",
      "website": "https://www.usebruno.com",
      "capabilities": ["offline-editing", "git-versioning", "scripting"],
      "replaces": ["postman", "insomnia"],
      "installation": { "macOS": "brew install bruno", "Windows": "winget install Bruno.Bruno" },
      "security_verified": true,
      "relevance_score": "10.00"
    }
  ]
}

🔹 get_app_details

Retrieve complete metadata, license status, self-hosting configurations, and migration notes for a specific app ID.

• Parameters:
  • app_id (string, required): Unique identifier of the app (e.g. bruno, vscodium, ollama, podman).

🔹 find_foss_alternative

Locate FOSS/free replacements for commercial proprietary software with migration difficulty and import capability assessment.

• Parameters:
  • paid_software (string, required): Name of commercial software to replace (e.g. postman, vscode, photoshop, docker-desktop, firebase).

---

2. MCP Resources Surface (Read-only Context Loading)

AI Agents can read structured dataset resources directly into context without invoking tool steps:

• devstack://registry: Returns the complete aggregated application registry JSON.
• devstack://categories: Returns structured taxonomy breakdown with entry counts per category.
• devstack://app/{id}: Direct entity URI lookup for individual apps (e.g. devstack://app/bruno).

---

3. MCP Prompts Surface (Reusable Agent Workflows)

• audit_project_dependencies_for_foss: Scans workspace configuration files (package.json, docker-compose.yml) and prompts the AI agent to audit proprietary dependencies and suggest open-source replacements.
• recommend_open_source_stack: Prompts the AI agent to query the registry and recommend a 100% open-source software stack tailored to specific application requirements.

---

⚙️ Architecture & 3-Tier Offline Cache

flowchart TD
    subgraph GitHub Curation
        A[apps/**/*.json - Community JSON Files] --> B[GitHub Action: validate-pr.yml]
        C[schema/app.schema.json v2] --> B
        B -->|Passes Regex Audit| D[GitHub Action: build-registry-and-readme.yml]
        D --> E[dist/registry.json]
    end

    subgraph Distribution & CDN
        E --> F[GitHub Pages CDN / Raw Content]
    end

    subgraph MCP Server Execution
        subgraph Hybrid Cache Manager
            G1[Tier 1: Bundled NPM Snapshot - 0ms]
            G2[Tier 2: ~/.cache/awesome-mcp-dev-stack-selector/registry.json]
            G3[Tier 3: Non-Blocking Background ETag Sync]
            F -.->|Async Update| G3
            G3 -.-> G2
            G1 -->|Fallback| G2
        end

        G2 --> H[In-Memory BM25 Search Engine]
        H --> I[npx @awesome-mcp-dev-stack-selector/mcp-server Stdio]
    end

    subgraph Client Environments
        I --> J[AI Agents: Antigravity / Cursor / Claude / VS Code]
    end

3-Tier Caching Rationale

1. Tier 1 (Bundled Snapshot): Ships compiled inside the NPM package so the MCP server initializes in 0ms even with zero internet connectivity.
2. Tier 2 (Disk Cache): Caches fetched registry datasets in ~/.cache/awesome-mcp-dev-stack-selector/registry.json with a 24-hour TTL.
3. Tier 3 (Background Sync): Issues non-blocking HTTP HEAD requests to GitHub Pages to check for dataset ETag changes without delaying tool execution.

---

📚 Apps Directory (29 Verified Entries)

🛠️ Developer Tools & IDEs

App	License	Tagline	Capabilities	Replaces	One-Line Install
Bruno	MIT	Fast, offline-first, Git-friendly open-source API client	offline-editing git-versioning scripting	postman, insomnia	brew install bruno
DBeaver Community	Apache-2.0	Free multi-platform database tool for developers and DBAs	sql-editor schema-visualizer data-export	datagrip, navicat	brew install dbeaver-community
Ghostty	MIT	Fast, feature-rich, cross-platform terminal emulator	gpu-accelerated native-rendering ligature-support	iterm2	brew install --cask ghostty
Hoppscotch	MIT	Open Source API Development Ecosystem	self-hosting web-based graphql-client	postman	brew install --cask hoppscotch
LazyGit	MIT	Simple terminal UI for git commands	git-versioning interactive-rebase conflict-resolution	gitkraken	brew install lazygit
VSCodium	MIT	Free and open-source binaries of VS Code without telemetry or tracking	extension-marketplace integrated-terminal git-integration	vscode	brew install vscodium
Zed	GPL-3.0-or-later	High-performance multiplayer code editor	gpu-accelerated real-time-collaboration language-server-protocol	vscode	brew install --cask zed

🤖 Local AI & LLM Tools

App	License	Tagline	Capabilities	Replaces	One-Line Install
AnythingLLM	MIT	Full-Stack Desktop AI Assistant & Local RAG	local-llm document-indexing vector-search	custom-gpt	brew install --cask anythingllm
GPT4All	MIT	Run Local LLMs on Any Hardware	local-llm offline-usable model-management	chatgpt-desktop	brew install --cask gpt4all
Jan	AGPL-3.0	Rethinking the AI Desktop Client	local-llm offline-usable openai-api-compatibility	chatgpt-desktop	brew install --cask jan
LibreChat	MIT	Enhanced ChatGPT Clone with Multi-Provider Support	multi-provider-llm self-hosting plugin-system	chatgpt	docker run -p 3080:3080 ghcr.io/danny-avila/librechat:latest
LM Studio	Proprietary-Free	Discover, download, and run local LLMs offline on Mac, Windows, and Linux	local-llm gui-chat model-downloader	chatgpt-desktop	brew install lm-studio
Ollama	MIT	Get up and running with Llama 3, Mistral, and other large language models locally	local-llm openai-api gpu-acceleration	openai-api	brew install ollama
Open WebUI	MIT	Self-Hosted WebUI for LLMs and Ollama	local-llm self-hosting document-indexing	chatgpt	docker run -p 3000:8080 ghcr.io/open-webui/open-webui:main

🐳 Container & Infrastructure

App	License	Tagline	Capabilities	Replaces	One-Line Install
K3s	Apache-2.0	Lightweight Kubernetes for Local & Edge Environments	container-orchestration lightweight-runtime self-hosting	docker-desktop	brew install k3d
OpenTofu	MPL-2.0	Open Source Infrastructure as Code Engine	infrastructure-as-code declarative-state multi-cloud	terraform	brew install opentofu
PocketBase	MIT	Open Source backend in 1 file with real-time database, auth, and file storage	realtime-subscriptions user-auth file-storage	firebase	brew install pocketbase
Podman	Apache-2.0	Daemonless, rootless open-source container engine	container-runtime rootless-containers pod-management	docker-desktop	brew install podman

🎨 Design & Media Production

App	License	Tagline	Capabilities	Replaces	One-Line Install
Blender	GPL-2.0-or-later	Free and open-source 3D creation suite	3d-modeling animation-rigging rendering-engine	maya, cinema4d	brew install --cask blender
GIMP	GPL-3.0-or-later	GNU Image Manipulation Program - Free & open source image editor	raster-editing layer-management plugin-support	photoshop	brew install gimp
Inkscape	GPL-3.0-or-later	Professional vector graphics editor for Linux, Windows and macOS	vector-editing svg-native bezier-curves	adobe-illustrator	brew install inkscape
OBS Studio	GPL-2.0-only	Free and open-source software for live streaming and recording	live-streaming screen-recording scene-composition	streamlabs	brew install --cask obs
Penpot	MPL-2.0	Open Source Design & Prototyping Platform	self-hosting web-based vector-editing	figma	docker run -it --rm penpot/backend:latest

📝 Knowledge & Productivity

App	License	Tagline	Capabilities	Replaces	One-Line Install
Logseq	AGPL-3.0	Privacy-first, open-source knowledge management	offline-editing bidirectional-linking graph-visualization	notion	brew install --cask logseq

---

🛡️ Supply-Chain Safety & CI Governance

Community pull requests submitting new apps in apps/**/*.json must adhere to strict security guardrails:

• Schema Validation: Verified against JSON Schema draft 2020-12 using Ajv.
• Safe Installation Command Regex: Package manager installation strings are strictly validated against approved patterns (brew install [a-z0-9-]+, winget install [A-Za-z0-9\.-]+, snap install [a-z0-9-]+).
• Forbidden Operators: Shell chaining operators (&&, ;, ||, backticks, subshells) are strictly forbidden to protect developer environments against Remote Code Execution (RCE).
• 3-Strike Circuit Breaker Audit: Nightly health checks require 3 consecutive failures over 48 hours before marking an app degraded, preventing false positives.

---

🤝 Contributing an App

We welcome community pull requests!

1. Add a JSON file in apps/<category>/<app-id>.json following schema/app.schema.json.
2. Test locally using:

   npm run test
   

3. Open a Pull Request — GitHub Actions will run automated schema, security, and integration audits.

---

📄 License

MIT © 2026 Awesome MCP Dev Stack Selector Maintainers