Stacksfinder

io.github.hoklimsPublished by GitHub account hoklimsv1.3.7Updated Oct 27, 2026

Deterministic tech stack recommendations, audits, and project estimates. No hallucinations.

VerifiedSTDIODesktop onlyDeveloper ToolsData & Analytics

Overview

AI-generated overview

Gives an assistant deterministic tech stack recommendations, technology comparisons, stack audits and project estimates through the Stacksfinder service.

What you can do
  • List, analyze and compare technologies with six-dimension scores, strengths and weaknesses
  • Recommend a full stack for a project type, with priorities and constraints on paid tiers
  • Run technical debt audits on a stack, fetch and compare audit reports, and check quotas
  • Estimate project scope, hours, pricing and market analysis by region and seniority
  • Generate MCP project kits, analyze a repository for relevant MCP servers, and prepare or execute MCP install commands
When to use it
Useful when choosing a framework, database or hosting stack for a new project, comparing candidate technologies, auditing an existing stack for outdated or vulnerable dependencies, or producing a rough scope and price estimate for a client project.
Requirements
Runs locally via npx from the npm package @stacksfinder/mcp-server, so Node.js is needed; Windows setups use a cmd wrapper. Network access to the Stacksfinder API is required. An API key in STACKSFINDER_API_KEY unlocks Pro, estimator and audit tools; eight tools work without an account. Optional STACKSFINDER_API_URL and STACKSFINDER_MCP_DEBUG variables.
Before you install
Pro, estimator and audit tools need a paid API key from the vendor's pricing page, and the free recommendation is limited to once per day. The server sends project descriptions, repository details and stack information to the Stacksfinder API. Installation tools write a .env-mcp file for credentials and generate commands that install other MCP servers, so review them before running. Key management tools can create and revoke API keys.

Installation

In SourceWeft

  1. Open Stacksfinder in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@stacksfinder/mcp-server

[npm version] [License: MIT] [MCP Registry] [LobeHub]

MCP (Model Context Protocol) server that brings deterministic tech stack recommendations to LLM clients like Claude, Cursor, Windsurf, and other MCP-compatible tools.

Try it free — 8 tools work without an account, including a daily demo recommendation and MCP project kit.

Quick Start

Claude Code (CLI)

bash
# macOS/Linuxclaude mcp add stacksfinder npx -y @stacksfinder/mcp-server
# Windows (requires cmd wrapper)claude mcp add-json stacksfinder '{  "command": "cmd",  "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],  "env": {"STACKSFINDER_API_KEY": "sk_live_xxx"}}'
# With API key (macOS/Linux)claude mcp add-json stacksfinder '{  "command": "npx",  "args": ["-y", "@stacksfinder/mcp-server"],  "env": {"STACKSFINDER_API_KEY": "sk_live_xxx"}}'

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

macOS/Linux:

json
{  "mcpServers": {    "stacksfinder": {      "command": "npx",      "args": ["-y", "@stacksfinder/mcp-server"],      "env": {        "STACKSFINDER_API_KEY": "sk_live_xxx"      }    }  }}

Windows:

json
{  "mcpServers": {    "stacksfinder": {      "command": "cmd",      "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],      "env": {        "STACKSFINDER_API_KEY": "sk_live_xxx"      }    }  }}

Cursor / Windsurf

Add to .cursor/mcp.json or .windsurf/mcp.json in your project root:

macOS/Linux:

json
{  "mcpServers": {    "stacksfinder": {      "command": "npx",      "args": ["-y", "@stacksfinder/mcp-server"],      "env": {        "STACKSFINDER_API_KEY": "sk_live_xxx"      }    }  }}

Windows:

json
{  "mcpServers": {    "stacksfinder": {      "command": "cmd",      "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],      "env": {        "STACKSFINDER_API_KEY": "sk_live_xxx"      }    }  }}

VS Code + Copilot

Add to .vscode/mcp.json:

macOS/Linux:

json
{  "servers": {    "stacksfinder": {      "command": "npx",      "args": ["-y", "@stacksfinder/mcp-server"],      "env": {        "STACKSFINDER_API_KEY": "sk_live_xxx"      }    }  }}

Windows:

json
{  "servers": {    "stacksfinder": {      "command": "cmd",      "args": ["/c", "npx", "-y", "@stacksfinder/mcp-server"],      "env": {        "STACKSFINDER_API_KEY": "sk_live_xxx"      }    }  }}

ChatGPT Developer Mode

StacksFinder is compatible with ChatGPT Developer Mode (available on Pro, Plus, Business, Enterprise, and Education accounts).

Prerequisites
  • ChatGPT Pro, Plus, Business, Enterprise, or Education account
  • Developer Mode enabled in ChatGPT settings
  • Note: Business/Enterprise workspaces may require admin approval
Setup Steps
  1. Enable Developer Mode: Go to Settings → Apps → Advanced settings → toggle "Developer mode"
  2. Create App: Go to Settings → Apps → Create
  3. Enter details:
    • Name: StacksFinder
    • URL: https://smithery.ai/server/hoklims/stacksfinder-mcp/mcp (or your self-hosted URL)
    • Protocol: Streaming HTTP
    • Description: Deterministic tech stack recommendations
  4. Verify: Click Create and confirm the 23 tools appear
Important Notes
  • Developer Mode does NOT require search/fetch tools (those are only for Deep Research)
  • Tools with readOnlyHint: true won't ask for confirmation in ChatGPT
  • Rate limited to 60 requests/minute per IP
  • Uses Streaming HTTP transport (not SSE)
Supported Protocols
ProtocolStatus
Streaming HTTP✅ Supported
SSE❌ Not supported

Available Tools

Free Tools (no account required)

ToolDescription
list_technologiesList all 80+ tech IDs by category
analyze_tech6-dimension scores, strengths, weaknesses, compatible techs
compare_techsSide-by-side comparison of 2-4 technologies
recommend_stackFREE 1x/day — Full stack recommendation for any project type

Estimator Tools (requires API key)

ToolDescription
estimate_projectEstimate scope, pricing, and market analysis for a project
get_estimate_quotaCheck your remaining estimate quota (weekly/monthly)

Pro Tools (requires API key)

ToolDescription
recommend_stackUnlimited recommendations with priorities & constraints
get_blueprintFetch existing blueprint by ID
create_blueprintGenerate new blueprint with AI narrative
setup_api_keyAuthenticate and create API key from MCP
list_api_keysList your API keys
revoke_api_keyRevoke an API key

Audit Tools (requires API key)

ToolDescription
create_auditRun technical debt audit on your stack
get_auditFetch audit report by ID
list_auditsList your audit reports
compare_auditsCompare two audits to track progress
get_audit_quotaCheck your remaining audit quota
get_migration_recommendationAnalyze audit for migration opportunities with builder constraints

Project Kit Tools (no API key required)

ToolDescription
generate_mcp_kitGenerate optimal tech stack + MCP recommendations from project description
analyze_repo_mcpsAnalyze your repository and recommend relevant MCP servers
prepare_mcp_installationDetect MCPs, generate .env-mcp template for credentials
execute_mcp_installationParse .env-mcp and generate IDE install commands

Get your API key at stacksfinder.com/pricing

Tool Examples

list_technologies

> list_technologies category="database"
Available databases:- postgres (PostgreSQL)- sqlite (SQLite)- supabase (Supabase)- planetscale (PlanetScale)- turso (Turso)- neon (Neon)

analyze_tech

> analyze_tech technology="sveltekit" context="mvp"
## SvelteKit Analysis (MVP Context)
| Dimension | Score | Grade ||-----------|-------|-------|| Performance | 92 | A || DX | 88 | A || Ecosystem | 72 | B || Maintainability | 85 | A || Cost | 90 | A || Compliance | 75 | B |
**Overall: 84/100 (A)**
Strengths:- Compiler-first architecture, tiny bundles- Excellent TypeScript support- Built-in SSR, SSG, and edge rendering
Weaknesses:- Smaller ecosystem than React- Fewer enterprise case studies

compare_techs

> compare_techs technologies=["nextjs", "sveltekit", "nuxt"]
## Comparison: Next.js vs SvelteKit vs Nuxt
| Tech | Score | Grade ||------|-------|-------|| Next.js | 82 | A || SvelteKit | 84 | A || Nuxt | 79 | B |
Per-dimension winners:- Performance: SvelteKit (+10)- DX: SvelteKit (+3)- Ecosystem: Next.js (+15)

recommend_stack (Free Demo)

> recommend_stack projectType="saas" scale="mvp"
## Recommended Stack for SaaS (MVP)
| Category | Technology | Score | Grade ||----------|------------|-------|-------|| meta-framework | SvelteKit | 84 | A || database | Supabase | 82 | A || orm | Drizzle | 86 | A || auth | Better Auth | 80 | A || hosting | Vercel | 85 | A || payments | Paddle | 86 | A |
**Confidence**: medium (demo mode)
---Want more? Upgrade to Pro for custom priorities, constraints, and AI narratives.

create_audit (Pro)

> 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"}]
## Audit Report: Q1 2026 Review
**Health Score: 72/100** (warning)
| Severity | Count ||----------|-------|| [CRITICAL] | 2 || [HIGH] | 1 || [MEDIUM] | 3 || [LOW] | 2 || [INFO] | 5 |
### Critical Findings
**[CRITICAL] Security vulnerability in lodash** (lodash 4.17.20)CVE-2021-23337 - Prototype pollution vulnerability> Upgrade to lodash 4.17.21 or later
**[CRITICAL] Outdated Express version** (express 4.17.0)Express 4.17.0 is missing security patches> Upgrade to express 4.21+ for security fixes

compare_audits (Pro)

> compare_audits baseAuditId="uuid-jan" compareAuditId="uuid-mar"
## Audit Comparison
**Trend: Improving** (+16 health score)
| Metric | January | March ||--------|---------|-------|| Health Score | 62 | 78 || Critical | 4 | 1 || High | 6 | 3 |
### Resolved Issues (6)- [x] Critical: lodash vulnerability- [x] High: moment.js deprecation- [x] High: outdated Node version

estimate_project (Pro)

> 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"
## Project Estimate
**ID**: `est_abc123`**Confidence**: 85%**Pricing Table Version**: 2026-01
### Scope Analysis
**Total Hours**: 280 - 420h**Complexity**: high**Buffer**: 10% (28-42h)
#### Feature Breakdown
| Feature | Hours | Complexity ||---------|-------|------------|| User Authentication | 16-24h | simple || Team Workspaces | 32-48h | medium || Task Boards | 48-72h | complex || Real-time Collaboration | 40-60h | complex || File Attachments | 24-36h | medium || Stripe Integration | 32-48h | medium || Email Notifications | 16-24h | simple |
### Pricing (EUR)
| Seniority | Min | Max ||-----------|-----|-----|| junior | 12 000 € | 21 000 € || mid | 18 000 € | 33 000 € || senior | 28 000 € | 50 400 € || expert | 40 000 € | 75 600 € |
**Adjustments Applied** (×1.15):- Payment Integration: +5%- Real-time Features: +10%

generate_mcp_kit (Free)

> generate_mcp_kit projectDescription="I'm building a SaaS for project management with Supabase and Stripe"
## Recommended Tech Stack
| Category | Technology | Score ||----------|------------|-------|| meta-framework | SvelteKit | 84 || database | Supabase | 82 || auth | Supabase Auth | 80 || payments | Stripe | 96 |
## Recommended MCPs
| MCP | Priority | Why ||-----|----------|-----|| supabase-mcp | High | Direct database access || stripe-mcp | High | Payment management || context7 | Medium | Documentation lookup |
## Install Configs
Claude Code:claude mcp add supabase-mcp npx -y @supabase/mcp-server

analyze_repo_mcps (Free)

> analyze_repo_mcps
## Detected Technologies- **Frontend**: SvelteKit (2.x)- **Database**: PostgreSQL (via Drizzle)- **Auth**: Lucia- **Payments**: Paddle
## Recommended MCPs
### High Priority**Neon MCP** (`@neondatabase/mcp-server`)- Direct database access and query execution- _Matched: drizzle, postgresql_
### Medium Priority**Context7** (`context7`)- Up-to-date documentation for any library- _Matched: universal_

prepare_mcp_installation (Free)

> prepare_mcp_installation
✅ Created .env-mcp with 3 MCPs requiring configuration.
## MCPs to Install
### 🔴 High Priority- **Neon MCP** (1 required vars)- **Paddle MCP** (2 required vars)
### 🟢 Low Priority- **Context7** (0 required vars)
Edit .env-mcp to add your credentials, then run execute_mcp_installation.

execute_mcp_installation (Free)

> execute_mcp_installation targetClient="claude-code"
✅ 2 MCPs ready, 1 pending credentials.
## Claude Code Installation
Run this command to install all ready MCPs:
claude mcp add neon-mcp npx -y @neondatabase/mcp-server && \claude mcp add context7 npx -y context7
## Post-Installation- Restart Claude Code to load new MCPs- Run `claude mcp list` to verify installation

Environment Variables

VariableRequiredDefaultDescription
STACKSFINDER_API_KEYFor Pro tools-API key from stacksfinder.com
STACKSFINDER_API_URLNohttps://stacksfinder.comAPI base URL
STACKSFINDER_MCP_DEBUGNofalseEnable debug logging

Score Dimensions

All technology scores are measured across 6 dimensions (0-100):

DimensionDescription
PerformanceRuntime speed, bundle size, optimization potential
DXLearning curve, tooling, documentation quality
EcosystemCommunity size, integrations, job market
MaintainabilityLong-term code health, upgrade path
CostHosting costs, licensing, operational overhead
ComplianceSecurity features, audit readiness

Contexts

Scores vary by project context:

  • default: General-purpose scores
  • mvp: Optimized for speed-to-market, lower cost
  • enterprise: Emphasizes compliance, maintainability, support

Error Handling

Structured errors with suggestions:

**Error (TECH_NOT_FOUND)**: Technology "nexjs" not found.**Suggestions**: nextjs, nuxt, nestjs

Troubleshooting

Debug mode

bash
STACKSFINDER_MCP_DEBUG=true npx @stacksfinder/mcp-server

Common issues

IssueSolution
"API key required"Get key at stacksfinder.com/pricing
"Daily limit reached"Wait 24h or upgrade to Pro
"Technology not found"Use list_technologies to see valid IDs

Development

bash
cd packages/mcp-serverbun installbun run buildbun run dev      # Watch modebun test         # Run tests

Contributing

Contributions are welcome! Please read our Contributing Guide before submitting a Pull Request.

For security vulnerabilities, please see our Security Policy.

Documentation

Links

Related

License

MIT

Source: README.md at commit adc47a1

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.3.7LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts