stacksfinder-mcp

🚀 @stacksfinder/mcp-server

MCP（模型上下文协议）服务器，为Claude、Cursor、Windsurf等LLM客户端以及其他支持MCP的工具提供确定性的技术栈推荐。

免费试用 — 无需账号即可使用4种工具，包括每日的演示推荐。

🚀 快速开始

Claude Code（命令行界面）

# 添加到Claude Code
claude mcp add stacksfinder npx -y @stacksfinder/mcp-server

# 使用API密钥以启用全部功能
claude mcp add-json stacksfinder '{
  "command": "npx",
  "args": ["-y", "@stacksfinder/mcp-server"],
  "env": {"STACKSFINDER_API_KEY": "sk_live_xxx"}
}'

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

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

Cursor / Windsurf

添加到项目根目录下的 .cursor/mcp.json 或 .windsurf/mcp.json：

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

VS Code + Copilot

添加到 .vscode/mcp.json：

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

✨ 主要特性

免费工具（无需账号）

| 工具 | 描述 | |------|-------------| | list_technologies | 按类别列出30多种技术ID | | analyze_tech | 提供6维评分、优势、劣势和兼容技术 | | compare_techs | 对2 - 4种技术进行并排比较 | | recommend_stack | 每天免费使用1次 — 为任何项目类型提供全栈推荐 |

专业工具（需要API密钥）

| 工具 | 描述 | |------|-------------| | recommend_stack | 可根据优先级和约束条件进行无限次推荐 | | get_blueprint | 根据ID获取现有蓝图 | | create_blueprint | 使用AI叙述生成新蓝图 | | setup_api_key | 从MCP进行身份验证并创建API密钥 | | list_api_keys | 列出您的API密钥 | | revoke_api_key | 撤销API密钥 |

您可以在 stacksfinder.com/pricing 获取API密钥。

💻 使用示例

list_technologies

> list_technologies category="database"

可用的数据库：
- postgres (PostgreSQL)
- sqlite (SQLite)
- supabase (Supabase)
- planetscale (PlanetScale)
- turso (Turso)
- neon (Neon)

analyze_tech

> analyze_tech technology="sveltekit" context="mvp"

## SvelteKit分析（MVP上下文）

| 维度 | 分数 | 等级 |
|-----------|-------|-------|
| 性能 | 92 | A |
| 开发者体验 | 88 | A |
| 生态系统 | 72 | B |
| 可维护性 | 85 | A |
| 成本 | 90 | A |
| 合规性 | 75 | B |

**总体评分：84/100 (A)**

优势：
- 以编译器为优先的架构，捆绑包小
- 出色的TypeScript支持
- 内置SSR、SSG和边缘渲染

劣势：
- 生态系统比React小
- 企业案例研究较少

compare_techs

> compare_techs technologies=["nextjs", "sveltekit", "nuxt"]

## 比较：Next.js vs SvelteKit vs Nuxt

| 技术 | 分数 | 等级 |
|------|-------|-------|
| Next.js | 82 | A |
| SvelteKit | 84 | A |
| Nuxt | 79 | B |

各维度获胜者：
- 性能：SvelteKit (+10)
- 开发者体验：SvelteKit (+3)
- 生态系统：Next.js (+15)

recommend_stack（免费演示）

> recommend_stack projectType="saas" scale="mvp"

## SaaS（MVP）推荐技术栈

| 类别 | 技术 | 分数 | 等级 |
|----------|------------|-------|-------|
| 元框架 | SvelteKit | 84 | A |
| 数据库 | Supabase | 82 | A |
| ORM | Drizzle | 86 | A |
| 身份验证 | Better Auth | 80 | A |
| 托管 | Vercel | 85 | A |
| 支付 | Paddle | 86 | A |

**置信度**：中等（演示模式）

---
想要更多功能？升级到专业版以获得自定义优先级、约束条件和AI叙述。

🔧 技术细节

环境变量

| 变量 | 是否必需 | 默认值 | 描述 | |----------|----------|---------|-------------| | STACKSFINDER_API_KEY | 专业工具需要 | - | 从stacksfinder.com获取的API密钥 | | STACKSFINDER_API_URL | 否 | https://stacksfinder.com | API基础URL | | STACKSFINDER_MCP_DEBUG | 否 | false | 启用调试日志记录 |

评分维度

所有技术评分均在6个维度（0 - 100）上进行衡量： | 维度 | 描述 | |-----------|-------------| | 性能 | 运行时速度、捆绑包大小、优化潜力 | | 开发者体验 | 学习曲线、工具、文档质量 | | 生态系统 | 社区规模、集成、就业市场 | | 可维护性 | 长期代码健康、升级路径 | | 成本 | 托管成本、许可费用、运营开销 | | 合规性 | 安全功能、审计准备情况 |

上下文

分数会根据项目上下文而有所不同：

• 默认：通用评分
• MVP：针对快速上市和低成本进行优化
• 企业：强调合规性、可维护性和支持

错误处理

提供带有建议的结构化错误：

**错误 (TECH_NOT_FOUND)**: 未找到技术 "nexjs"。
**建议**: nextjs, nuxt, nestjs

故障排除

调试模式

STACKSFINDER_MCP_DEBUG=true npx @stacksfinder/mcp-server

常见问题

| 问题 | 解决方案 | |-------|----------| | "需要API密钥" | 在 stacksfinder.com/pricing 获取密钥 | | "达到每日限制" | 等待24小时或升级到专业版 | | "未找到技术" | 使用 list_technologies 查看有效ID |

开发

cd packages/mcp-server
bun install
bun run build
bun run dev      # 监听模式
bun test         # 运行测试

📚 详细文档

• 网站：stacksfinder.com
• 定价：stacksfinder.com/pricing
• GitHub：github.com/hoklims/stacksfinder-mcp
• npm：@stacksfinder/mcp-server

📄 许可证

本项目采用MIT许可证。