@stacksfinder/mcp-server 1.2.1 → 1.3.0

package/LICENSE

@@ -1,21 +1,21 @@
 MIT License
 
-  Copyright (c) 2025 StacksFinder
+Copyright (c) 2025-2026 StacksFinder
 
-  Permission is hereby granted, free of charge, to any person obtaining a copy
-  of this software and associated documentation files (the "Software"), to deal
-  in the Software without restriction, including without limitation the rights
-  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-  copies of the Software, and to permit persons to whom the Software is
-  furnished to do so, subject to the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-  The above copyright notice and this permission notice shall be included in all
-  copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-  SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,12 +1,12 @@
 # @stacksfinder/mcp-server
 
-[![smithery badge](https://smithery.ai/badge/hoklims/stacksfinder-mcp)](https://smithery.ai/server/hoklims/stacksfinder-mcp)
 [![npm version](https://img.shields.io/npm/v/@stacksfinder/mcp-server.svg)](https://www.npmjs.com/package/@stacksfinder/mcp-server)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![LobeHub](https://img.shields.io/badge/LobeHub-MCP%20Directory-blue.svg)](https://lobehub.com/fr/mcp/hoklims-stacksfinder-mcp)
 
 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 tools.
+**Try it free** — 8 tools work without an account, including a daily demo recommendation and MCP project kit.
 
 ## Quick Start
 
@@ -24,7 +24,7 @@ claude mcp add-json stacksfinder '{
 }'
 ```
 
-### Claude Desktop
+### Claude Code
 
 Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
 
@@ -87,12 +87,14 @@ Add to `.vscode/mcp.json`:
 | `list_technologies` | List all 30+ tech IDs by category |
 | `analyze_tech` | 6-dimension scores, strengths, weaknesses, compatible techs |
 | `compare_techs` | Side-by-side comparison of 2-4 technologies |
-| `recommend_stack_demo` | **FREE 1x/day** — Full stack recommendation for any project type |
-| `check_mcp_compatibility` | 🆕 Check conflicts, redundancies, and synergies between MCP servers |
-| `generate_mcp_kit` | 🆕 Generate optimal stack + recommended MCPs from project description |
-| `analyze_repo_mcps` | 🆕 Analyze your repository and recommend relevant MCP servers |
-| `prepare_mcp_installation` | 🆕 Detect MCPs needed and generate `.env-mcp` template |
-| `execute_mcp_installation` | 🆕 Parse `.env-mcp` and generate IDE install commands |
+| `recommend_stack` | **FREE 1x/day** — Full stack recommendation for any project type |
+
+### Estimator Tools (requires API key)
+
+| Tool | Description |
+|------|-------------|
+| `estimate_project` | Estimate scope, pricing, and market analysis for a project |
+| `get_estimate_quota` | Check your remaining estimate quota (weekly/monthly) |
 
 ### Pro Tools (requires API key)
 
@@ -105,7 +107,7 @@ Add to `.vscode/mcp.json`:
 | `list_api_keys` | List your API keys |
 | `revoke_api_key` | Revoke an API key |
 
-### Audit Tools (requires API key) 🆕
+### Audit Tools (requires API key)
 
 | Tool | Description |
 |------|-------------|
@@ -114,7 +116,16 @@ Add to `.vscode/mcp.json`:
 | `list_audits` | List your audit reports |
 | `compare_audits` | Compare two audits to track progress |
 | `get_audit_quota` | Check your remaining audit quota |
-| `get_migration_recommendation` | **NEW** Analyze audit for migration opportunities with builder constraints |
+| `get_migration_recommendation` | Analyze audit for migration opportunities with builder constraints |
+
+### Project Kit Tools (no API key required)
+
+| Tool | Description |
+|------|-------------|
+| `generate_mcp_kit` | Generate optimal tech stack + MCP recommendations from project description |
+| `analyze_repo_mcps` | Analyze your repository and recommend relevant MCP servers |
+| `prepare_mcp_installation` | Detect MCPs, generate `.env-mcp` template for credentials |
+| `execute_mcp_installation` | Parse `.env-mcp` and generate IDE install commands |
 
 Get your API key at [stacksfinder.com/pricing](https://stacksfinder.com/pricing)
 
@@ -210,25 +221,25 @@ Want more? Upgrade to Pro for custom priorities, constraints, and AI narratives.
 
 ## Audit Report: Q1 2026 Review
 
-**Health Score: 72/100** ⚠️
+**Health Score: 72/100** (warning)
 
 | Severity | Count |
 |----------|-------|
-| 🔴 Critical | 2 |
-| 🟠 High | 1 |
-| 🟡 Medium | 3 |
-| 🟢 Low | 2 |
-| ℹ️ Info | 5 |
+| [CRITICAL] | 2 |
+| [HIGH] | 1 |
+| [MEDIUM] | 3 |
+| [LOW] | 2 |
+| [INFO] | 5 |
 
 ### Critical Findings
 
-**🔴 Security vulnerability in lodash** (lodash 4.17.20)
+**[CRITICAL] Security vulnerability in lodash** (lodash 4.17.20)
 CVE-2021-23337 - Prototype pollution vulnerability
-→ Upgrade to lodash 4.17.21 or later
+> Upgrade to lodash 4.17.21 or later
 
-**🔴 Outdated Express version** (express 4.17.0)
+**[CRITICAL] Outdated Express version** (express 4.17.0)
 Express 4.17.0 is missing security patches
-→ Upgrade to express 4.21+ for security fixes
+> Upgrade to express 4.21+ for security fixes
 ```
 
 ### compare_audits (Pro)
@@ -238,7 +249,7 @@ Express 4.17.0 is missing security patches
 
 ## Audit Comparison
 
-**Trend: 📈 Improving** (+16 health score)
+**Trend: Improving** (+16 health score)
 
 | Metric | January | March |
 |--------|---------|-------|
@@ -247,46 +258,66 @@ Express 4.17.0 is missing security patches
 | High | 6 | 3 |
 
 ### Resolved Issues (6)
-- ✅ Critical: lodash vulnerability
-- ✅ High: moment.js deprecation
-- ✅ High: outdated Node version
+- [x] Critical: lodash vulnerability
+- [x] High: moment.js deprecation
+- [x] High: outdated Node version
 ```
 
-### check_mcp_compatibility 🆕
+### estimate_project (Pro)
 
 ```
-> check_mcp_compatibility mcps=["supabase-mcp", "neon-mcp", "prisma-mcp"]
+> 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
 
-## MCP Compatibility Check
+### Scope Analysis
 
-**Health Score: 65/100** (Grade: C)
+**Total Hours**: 280 - 420h
+**Complexity**: high
+**Buffer**: 10% (28-42h)
 
-### ⚠️ Conflicts (1)
-- **supabase-mcp** ↔ **neon-mcp**: Both provide database services
+#### Feature Breakdown
 
-### 🔄 Redundancies (1)
-- **prisma-mcp** + **supabase-mcp**: Supabase has built-in client
+| 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 |
 
-### ✅ Synergies (0)
-None detected
+### Pricing (EUR)
 
-### 💡 Suggestions
-- Choose one database provider (Supabase OR Neon)
-- If using Supabase, Prisma may be redundant
+| 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 🆕
+### generate_mcp_kit (Free)
 
 ```
-> generate_mcp_kit projectDescription="SaaS for project management with Supabase and Stripe"
+> generate_mcp_kit projectDescription="I'm building a SaaS for project management with Supabase and Stripe"
 
-## Recommended Stack
+## Recommended Tech Stack
 
 | Category | Technology | Score |
 |----------|------------|-------|
 | meta-framework | SvelteKit | 84 |
 | database | Supabase | 82 |
-| auth | Better Auth | 80 |
+| auth | Supabase Auth | 80 |
 | payments | Stripe | 96 |
 
 ## Recommended MCPs
@@ -294,45 +325,75 @@ None detected
 | MCP | Priority | Why |
 |-----|----------|-----|
 | supabase-mcp | High | Direct database access |
-| stripe-mcp | High | Payment integration |
-| github-mcp | Medium | Version control |
+| stripe-mcp | High | Payment management |
+| context7 | Medium | Documentation lookup |
+
+## Install Configs
 
-Install all with:
-claude mcp add-json supabase-mcp '{"command":"npx","args":["-y","@supabase/mcp"]}'
+Claude Code:
+claude mcp add supabase-mcp npx -y @supabase/mcp-server
 ```
 
-### prepare_mcp_installation 🆕
+### 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
 
-✅ Generated .env-mcp with 5 MCP(s) to install.
+✅ Created .env-mcp with 3 MCPs requiring configuration.
+
+## MCPs to Install
 
-📋 Next steps:
-1. Open .env-mcp
-2. Fill in the 3 required environment variable(s)
-3. Set INSTALL_xxx=false for any MCPs you want to skip
-4. Run execute_mcp_installation to install the MCPs
+### 🔴 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 🆕
+### execute_mcp_installation (Free)
 
 ```
 > execute_mcp_installation targetClient="claude-code"
 
-# MCP Installation Summary
+✅ 2 MCPs ready, 1 pending credentials.
+
+## Claude Code Installation
 
-- ✅ Ready to install: 3
-- ⏳ Missing credentials: 1
-- ⏭️ Skipped: 1
+Run this command to install all ready MCPs:
 
-## Ready to Install
-- ✅ **Supabase MCP** (`supabase-mcp`)
-- ✅ **GitHub MCP** (`github-mcp`)
-- ✅ **Context7 MCP** (`context7-mcp`)
+claude mcp add neon-mcp npx -y @neondatabase/mcp-server && \
+claude mcp add context7 npx -y context7
 
-## Installation Command
-claude mcp add-json supabase-mcp '...' && claude mcp add-json github-mcp '...'
+## Post-Installation
+- Restart Claude Code to load new MCPs
+- Run `claude mcp list` to verify installation
 ```
 
 ## Environment Variables
@@ -411,4 +472,4 @@ bun test         # Run tests
 
 ## License
 
-MIT
+MIT

package/dist/__tests__/mcp-tools.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Server Integration Tests
+ *
+ * Tests all 21 MCP tools to ensure they are functional.
+ * Run with: npm test or vitest
+ */
+export {};
+//# sourceMappingURL=mcp-tools.test.d.ts.map

package/dist/__tests__/mcp-tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/mcp-tools.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}