{
  "markdown": "# @stacksfinder/mcp-server\n\n[![npm version](https://img.shields.io/npm/v/@stacksfinder/mcp-server.svg)](https://www.npmjs.com/package/@stacksfinder/mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-8A2BE2.svg)](https://registry.modelcontextprotocol.io)\n[![LobeHub](https://img.shields.io/badge/LobeHub-MCP%20Directory-blue.svg)](https://lobehub.com/fr/mcp/hoklims-stacksfinder-mcp)\n\nMCP (Model Context Protocol) server that brings **deterministic tech stack recommendations** to LLM clients like Claude, Cursor, Windsurf, and other MCP-compatible tools.\n\n**Try it free** — 8 tools work without an account, including a daily demo recommendation and MCP project kit.\n\n## Quick Start\n\n### Claude Code (CLI)\n\n```bash\n# macOS/Linux\nclaude mcp add stacksfinder npx -y @stacksfinder/mcp-server\n\n# Windows (requires cmd wrapper)\nclaude mcp add-json stacksfinder '{\n  \"command\": \"cmd\",\n  \"args\": [\"/c\", \"npx\", \"-y\", \"@stacksfinder/mcp-server\"],\n  \"env\": {\"STACKSFINDER_API_KEY\": \"sk_live_xxx\"}\n}'\n\n# With API key (macOS/Linux)\nclaude mcp add-json stacksfinder '{\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"@stacksfinder/mcp-server\"],\n  \"env\": {\"STACKSFINDER_API_KEY\": \"sk_live_xxx\"}\n}'\n```\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n**macOS/Linux:**\n```json\n{\n  \"mcpServers\": {\n    \"stacksfinder\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@stacksfinder/mcp-server\"],\n      \"env\": {\n        \"STACKSFINDER_API_KEY\": \"sk_live_xxx\"\n      }\n    }\n  }\n}\n```\n\n**Windows:**\n```json\n{\n  \"mcpServers\": {\n    \"stacksfinder\": {\n      \"command\": \"cmd\",\n      \"args\": [\"/c\", \"npx\", \"-y\", \"@stacksfinder/mcp-server\"],\n      \"env\": {\n        \"STACKSFINDER_API_KEY\": \"sk_live_xxx\"\n      }\n    }\n  }\n}\n```\n\n### Cursor / Windsurf\n\nAdd to `.cursor/mcp.json` or `.windsurf/mcp.json` in your project root:\n\n**macOS/Linux:**\n```json\n{\n  \"mcpServers\": {\n    \"stacksfinder\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@stacksfinder/mcp-server\"],\n      \"env\": {\n        \"STACKSFINDER_API_KEY\": \"sk_live_xxx\"\n      }\n    }\n  }\n}\n```\n\n**Windows:**\n```json\n{\n  \"mcpServers\": {\n    \"stacksfinder\": {\n      \"command\": \"cmd\",\n      \"args\": [\"/c\", \"npx\", \"-y\", \"@stacksfinder/mcp-server\"],\n      \"env\": {\n        \"STACKSFINDER_API_KEY\": \"sk_live_xxx\"\n      }\n    }\n  }\n}\n```\n\n### VS Code + Copilot\n\nAdd to `.vscode/mcp.json`:\n\n**macOS/Linux:**\n```json\n{\n  \"servers\": {\n    \"stacksfinder\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@stacksfinder/mcp-server\"],\n      \"env\": {\n        \"STACKSFINDER_API_KEY\": \"sk_live_xxx\"\n      }\n    }\n  }\n}\n```\n\n**Windows:**\n```json\n{\n  \"servers\": {\n    \"stacksfinder\": {\n      \"command\": \"cmd\",\n      \"args\": [\"/c\", \"npx\", \"-y\", \"@stacksfinder/mcp-server\"],\n      \"env\": {\n        \"STACKSFINDER_API_KEY\": \"sk_live_xxx\"\n      }\n    }\n  }\n}\n```\n\n### ChatGPT Developer Mode\n\nStacksFinder is compatible with **ChatGPT Developer Mode** (available on Pro, Plus, Business, Enterprise, and Education accounts).\n\n#### Prerequisites\n\n- ChatGPT Pro, Plus, Business, Enterprise, or Education account\n- Developer Mode enabled in ChatGPT settings\n- Note: Business/Enterprise workspaces may require admin approval\n\n#### Setup Steps\n\n1. **Enable Developer Mode**: Go to Settings → Apps → Advanced settings → toggle \"Developer mode\"\n2. **Create App**: Go to Settings → Apps → Create\n3. **Enter details**:\n   - **Name**: StacksFinder\n   - **URL**: `https://smithery.ai/server/hoklims/stacksfinder-mcp/mcp` (or your self-hosted URL)\n   - **Protocol**: Streaming HTTP\n   - **Description**: Deterministic tech stack recommendations\n4. **Verify**: Click Create and confirm the 23 tools appear\n\n#### Important Notes\n\n- **Developer Mode does NOT require search/fetch tools** (those are only for Deep Research)\n- Tools with `readOnlyHint: true` won't ask for confirmation in ChatGPT\n- Rate limited to 60 requests/minute per IP\n- Uses **Streaming HTTP** transport (not SSE)\n\n#### Supported Protocols\n\n| Protocol | Status |\n|----------|--------|\n| Streaming HTTP | ✅ Supported |\n| SSE | ❌ Not supported |\n\n## Available Tools\n\n### Free Tools (no account required)\n\n| Tool | Description |\n|------|-------------|\n| `list_technologies` | List all 80+ tech IDs by category |\n| `analyze_tech` | 6-dimension scores, strengths, weaknesses, compatible techs |\n| `compare_techs` | Side-by-side comparison of 2-4 technologies |\n| `recommend_stack` | **FREE 1x/day** — Full stack recommendation for any project type |\n\n### Estimator Tools (requires API key)\n\n| Tool | Description |\n|------|-------------|\n| `estimate_project` | Estimate scope, pricing, and market analysis for a project |\n| `get_estimate_quota` | Check your remaining estimate quota (weekly/monthly) |\n\n### Pro Tools (requires API key)\n\n| Tool | Description |\n|------|-------------|\n| `recommend_stack` | Unlimited recommendations with priorities & constraints |\n| `get_blueprint` | Fetch existing blueprint by ID |\n| `create_blueprint` | Generate new blueprint with AI narrative |\n| `setup_api_key` | Authenticate and create API key from MCP |\n| `list_api_keys` | List your API keys |\n| `revoke_api_key` | Revoke an API key |\n\n### Audit Tools (requires API key)\n\n| Tool | Description |\n|------|-------------|\n| `create_audit` | Run technical debt audit on your stack |\n| `get_audit` | Fetch audit report by ID |\n| `list_audits` | List your audit reports |\n| `compare_audits` | Compare two audits to track progress |\n| `get_audit_quota` | Check your remaining audit quota |\n| `get_migration_recommendation` | Analyze audit for migration opportunities with builder constraints |\n\n### Project Kit Tools (no API key required)\n\n| Tool | Description |\n|------|-------------|\n| `generate_mcp_kit` | Generate optimal tech stack + MCP recommendations from project description |\n| `analyze_repo_mcps` | Analyze your repository and recommend relevant MCP servers |\n| `prepare_mcp_installation` | Detect MCPs, generate `.env-mcp` template for credentials |\n| `execute_mcp_installation` | Parse `.env-mcp` and generate IDE install commands |\n\nGet your API key at [stacksfinder.com/pricing](https://stacksfinder.com/pricing)\n\n## Tool Examples\n\n### list_technologies\n\n```\n> list_technologies category=\"database\"\n\nAvailable databases:\n- postgres (PostgreSQL)\n- sqlite (SQLite)\n- supabase (Supabase)\n- planetscale (PlanetScale)\n- turso (Turso)\n- neon (Neon)\n```\n\n### analyze_tech\n\n```\n> analyze_tech technology=\"sveltekit\" context=\"mvp\"\n\n## SvelteKit Analysis (MVP Context)\n\n| Dimension | Score | Grade |\n|-----------|-------|-------|\n| Performance | 92 | A |\n| DX | 88 | A |\n| Ecosystem | 72 | B |\n| Maintainability | 85 | A |\n| Cost | 90 | A |\n| Compliance | 75 | B |\n\n**Overall: 84/100 (A)**\n\nStrengths:\n- Compiler-first architecture, tiny bundles\n- Excellent TypeScript support\n- Built-in SSR, SSG, and edge rendering\n\nWeaknesses:\n- Smaller ecosystem than React\n- Fewer enterprise case studies\n```\n\n### compare_techs\n\n```\n> compare_techs technologies=[\"nextjs\", \"sveltekit\", \"nuxt\"]\n\n## Comparison: Next.js vs SvelteKit vs Nuxt\n\n| Tech | Score | Grade |\n|------|-------|-------|\n| Next.js | 82 | A |\n| SvelteKit | 84 | A |\n| Nuxt | 79 | B |\n\nPer-dimension winners:\n- Performance: SvelteKit (+10)\n- DX: SvelteKit (+3)\n- Ecosystem: Next.js (+15)\n```\n\n### recommend_stack (Free Demo)\n\n```\n> recommend_stack projectType=\"saas\" scale=\"mvp\"\n\n## Recommended Stack for SaaS (MVP)\n\n| Category | Technology | Score | Grade |\n|----------|------------|-------|-------|\n| meta-framework | SvelteKit | 84 | A |\n| database | Supabase | 82 | A |\n| orm | Drizzle | 86 | A |\n| auth | Better Auth | 80 | A |\n| hosting | Vercel | 85 | A |\n| payments | Paddle | 86 | A |\n\n**Confidence**: medium (demo mode)\n\n---\nWant more? Upgrade to Pro for custom priorities, constraints, and AI narratives.\n```\n\n### create_audit (Pro)\n\n```\n> create_audit name=\"Q1 2026 Review\" technologies=[{name:\"react\",version:\"18.2.0\"},{name:\"lodash\",version:\"4.17.20\"},{name:\"express\",version:\"4.17.0\"}]\n\n## Audit Report: Q1 2026 Review\n\n**Health Score: 72/100** (warning)\n\n| Severity | Count |\n|----------|-------|\n| [CRITICAL] | 2 |\n| [HIGH] | 1 |\n| [MEDIUM] | 3 |\n| [LOW] | 2 |\n| [INFO] | 5 |\n\n### Critical Findings\n\n**[CRITICAL] Security vulnerability in lodash** (lodash 4.17.20)\nCVE-2021-23337 - Prototype pollution vulnerability\n> Upgrade to lodash 4.17.21 or later\n\n**[CRITICAL] Outdated Express version** (express 4.17.0)\nExpress 4.17.0 is missing security patches\n> Upgrade to express 4.21+ for security fixes\n```\n\n### compare_audits (Pro)\n\n```\n> compare_audits baseAuditId=\"uuid-jan\" compareAuditId=\"uuid-mar\"\n\n## Audit Comparison\n\n**Trend: Improving** (+16 health score)\n\n| Metric | January | March |\n|--------|---------|-------|\n| Health Score | 62 | 78 |\n| Critical | 4 | 1 |\n| High | 6 | 3 |\n\n### Resolved Issues (6)\n- [x] Critical: lodash vulnerability\n- [x] High: moment.js deprecation\n- [x] High: outdated Node version\n```\n\n### estimate_project (Pro)\n\n```\n> estimate_project specs=\"Build a SaaS project management tool with: user authentication, team workspaces, task boards with drag-and-drop, real-time collaboration, file attachments, Stripe billing integration, and email notifications. Target: small to medium teams.\" region=\"france\" seniorityLevel=\"mid\"\n\n## Project Estimate\n\n**ID**: `est_abc123`\n**Confidence**: 85%\n**Pricing Table Version**: 2026-01\n\n### Scope Analysis\n\n**Total Hours**: 280 - 420h\n**Complexity**: high\n**Buffer**: 10% (28-42h)\n\n#### Feature Breakdown\n\n| Feature | Hours | Complexity |\n|---------|-------|------------|\n| User Authentication | 16-24h | simple |\n| Team Workspaces | 32-48h | medium |\n| Task Boards | 48-72h | complex |\n| Real-time Collaboration | 40-60h | complex |\n| File Attachments | 24-36h | medium |\n| Stripe Integration | 32-48h | medium |\n| Email Notifications | 16-24h | simple |\n\n### Pricing (EUR)\n\n| Seniority | Min | Max |\n|-----------|-----|-----|\n| junior | 12 000 € | 21 000 € |\n| mid | 18 000 € | 33 000 € |\n| senior | 28 000 € | 50 400 € |\n| expert | 40 000 € | 75 600 € |\n\n**Adjustments Applied** (×1.15):\n- Payment Integration: +5%\n- Real-time Features: +10%\n```\n\n### generate_mcp_kit (Free)\n\n```\n> generate_mcp_kit projectDescription=\"I'm building a SaaS for project management with Supabase and Stripe\"\n\n## Recommended Tech Stack\n\n| Category | Technology | Score |\n|----------|------------|-------|\n| meta-framework | SvelteKit | 84 |\n| database | Supabase | 82 |\n| auth | Supabase Auth | 80 |\n| payments | Stripe | 96 |\n\n## Recommended MCPs\n\n| MCP | Priority | Why |\n|-----|----------|-----|\n| supabase-mcp | High | Direct database access |\n| stripe-mcp | High | Payment management |\n| context7 | Medium | Documentation lookup |\n\n## Install Configs\n\nClaude Code:\nclaude mcp add supabase-mcp npx -y @supabase/mcp-server\n```\n\n### analyze_repo_mcps (Free)\n\n```\n> analyze_repo_mcps\n\n## Detected Technologies\n- **Frontend**: SvelteKit (2.x)\n- **Database**: PostgreSQL (via Drizzle)\n- **Auth**: Lucia\n- **Payments**: Paddle\n\n## Recommended MCPs\n\n### High Priority\n**Neon MCP** (`@neondatabase/mcp-server`)\n- Direct database access and query execution\n- _Matched: drizzle, postgresql_\n\n### Medium Priority\n**Context7** (`context7`)\n- Up-to-date documentation for any library\n- _Matched: universal_\n```\n\n### prepare_mcp_installation (Free)\n\n```\n> prepare_mcp_installation\n\n✅ Created .env-mcp with 3 MCPs requiring configuration.\n\n## MCPs to Install\n\n### 🔴 High Priority\n- **Neon MCP** (1 required vars)\n- **Paddle MCP** (2 required vars)\n\n### 🟢 Low Priority\n- **Context7** (0 required vars)\n\nEdit .env-mcp to add your credentials, then run execute_mcp_installation.\n```\n\n### execute_mcp_installation (Free)\n\n```\n> execute_mcp_installation targetClient=\"claude-code\"\n\n✅ 2 MCPs ready, 1 pending credentials.\n\n## Claude Code Installation\n\nRun this command to install all ready MCPs:\n\nclaude mcp add neon-mcp npx -y @neondatabase/mcp-server && \\\nclaude mcp add context7 npx -y context7\n\n## Post-Installation\n- Restart Claude Code to load new MCPs\n- Run `claude mcp list` to verify installation\n```\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `STACKSFINDER_API_KEY` | For Pro tools | - | API key from stacksfinder.com |\n| `STACKSFINDER_API_URL` | No | `https://stacksfinder.com` | API base URL |\n| `STACKSFINDER_MCP_DEBUG` | No | `false` | Enable debug logging |\n\n## Score Dimensions\n\nAll technology scores are measured across 6 dimensions (0-100):\n\n| Dimension | Description |\n|-----------|-------------|\n| **Performance** | Runtime speed, bundle size, optimization potential |\n| **DX** | Learning curve, tooling, documentation quality |\n| **Ecosystem** | Community size, integrations, job market |\n| **Maintainability** | Long-term code health, upgrade path |\n| **Cost** | Hosting costs, licensing, operational overhead |\n| **Compliance** | Security features, audit readiness |\n\n## Contexts\n\nScores vary by project context:\n\n- **default**: General-purpose scores\n- **mvp**: Optimized for speed-to-market, lower cost\n- **enterprise**: Emphasizes compliance, maintainability, support\n\n## Error Handling\n\nStructured errors with suggestions:\n\n```\n**Error (TECH_NOT_FOUND)**: Technology \"nexjs\" not found.\n**Suggestions**: nextjs, nuxt, nestjs\n```\n\n## Troubleshooting\n\n### Debug mode\n\n```bash\nSTACKSFINDER_MCP_DEBUG=true npx @stacksfinder/mcp-server\n```\n\n### Common issues\n\n| Issue | Solution |\n|-------|----------|\n| \"API key required\" | Get key at [stacksfinder.com/pricing](https://stacksfinder.com/pricing) |\n| \"Daily limit reached\" | Wait 24h or upgrade to Pro |\n| \"Technology not found\" | Use `list_technologies` to see valid IDs |\n\n## Development\n\n```bash\ncd packages/mcp-server\nbun install\nbun run build\nbun run dev      # Watch mode\nbun test         # Run tests\n```\n\n## Contributing\n\nContributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) before submitting a Pull Request.\n\nFor security vulnerabilities, please see our [Security Policy](SECURITY.md).\n\n## Documentation\n\n- [CHANGELOG.md](CHANGELOG.md) - Version history and release notes\n- [CONTRIBUTING.md](CONTRIBUTING.md) - How to contribute\n- [SECURITY.md](SECURITY.md) - Security policy and vulnerability reporting\n\n## Links\n\n- **Website**: [stacksfinder.com](https://stacksfinder.com)\n- **Pricing**: [stacksfinder.com/pricing](https://stacksfinder.com/pricing)\n- **MCP Registry**: [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io) (Official Anthropic)\n- **Discord**: [discord.gg/scBHF2EumC](https://discord.gg/scBHF2EumC)\n- **Glama**: [glama.ai/mcp/servers/@stacksfinder/mcp-server](https://glama.ai/mcp/servers/@stacksfinder/mcp-server)\n- **Smithery**: [smithery.ai/server/hoklims/stacksfinder-mcp](https://smithery.ai/server/hoklims/stacksfinder-mcp)\n- **GitHub**: [github.com/hoklims/stacksfinder-mcp](https://github.com/hoklims/stacksfinder-mcp)\n- **npm**: [@stacksfinder/mcp-server](https://www.npmjs.com/package/@stacksfinder/mcp-server)\n\n## Related\n\n- **CLI**: [create-stacksfinder](https://www.npmjs.com/package/create-stacksfinder) — Scaffold projects from terminal\n- **Website**: [stacksfinder.dev](https://stacksfinder.dev) — Full web experience\n\n## License\n\nMIT\n",
  "bytes": 15359,
  "sha": "c9a284451161baa194c36d8aa890812e031f218830b6b45e09cf717f8baf9227",
  "repo_slug": "hoklims/stacksfinder-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hoklims_stacksfinder_dfadf065/readme"
}