Saas Brain Mcp

SaaS Brain MCP

使用 Claude AI 以自然语言询问有关 SaaS 业务的问题。

“哪些客户即将流失？” • “我本周的收入是多少？” • “哪些是我的最佳客户？”

无需仪表板，无需 SQL，只需提问。

功能介绍

SaaS Brain 是一个 MCP（Model Context Protocol）服务，可将 Claude AI 连接到你的 Stripe 和 Supabase 数据。用自然语言提问，即可立即获取智能业务洞察。

可用工具

工具	可查询内容
getRevenue	任意日期范围内的总收入
getTopCustomers	消费金额最高的客户
getActiveSubscriptions	所有有效订阅者及套餐信息
getInactiveUsers	N 天内未登录的用户
getUserActivity	特定用户的最近登录时间和活动
getChurnRiskUsers	已停止活跃的付费用户
getHighValueUsers	消费金额超过指定阈值的客户
getHighValueAtRiskUsers	当前已停止活跃的高消费客户

可以向 Claude 提出的问题示例

• “我 1 月到 3 月的收入是多少？”
• “列出消费金额最高的 5 位客户”
• “哪些用户有流失风险？”
• “哪些用户消费最多，但最近没有登录？”
• “为我的 SaaS 生成一份完整的健康状况报告”

技术栈

• Java 17 + Spring Boot
• Stripe API
• Supabase REST API
• Docker
• MCP Protocol (JSON-RPC 2.0)

前提条件

• Java 17+
• Maven
• Stripe 账户（免费账户即可，测试模式也可用）
• Supabase 项目（免费套餐即可）
• Claude.ai 账户（免费套餐即可）

设置

1. 克隆代码仓库

git clone https://github.com/Mohd16kaif/saas-brain-mcp.git
cd saas-brain-mcp

2. 添加 API 密钥

创建 src/main/resources/application.properties：

server.port=8080
spring.application.name=saas-brain-mcp

stripe.api.key=sk_test_YOUR_STRIPE_KEY
supabase.url=https://YOUR_PROJECT.supabase.co
supabase.key=YOUR_SERVICE_ROLE_KEY

从以下位置获取密钥：

• Stripe：dashboard.stripe.com → Developers → API Keys
• Supabase：app.supabase.com → Settings → API → service_role key

3. 在本地运行

mvn spring-boot:run

测试：

curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

部署到 Render（免费，全天候运行）

1. 在 GitHub 上 Fork 此代码仓库

2. 在 Render 上创建新的 Web 服务

• 前往 render.com → New → Web Service
• 连接你 Fork 的代码仓库
• 语言：Docker
• 分支：main
• 实例类型：Free

3. 在 Render 中添加环境变量

键	值
STRIPE_API_KEY	你的 Stripe 密钥
SUPABASE_URL	你的 Supabase 项目 URL
SUPABASE_KEY	你的 Supabase service_role 密钥

4. 部署

Render 会自动构建并部署。你的服务将在以下地址上线：

https://your-service-name.onrender.com

连接到 Claude.ai

1. 前往 claude.ai → Settings → Connectors
2. 点击 Add custom connector
3. 名称：saas-brain
4. URL：https://your-render-url.onrender.com/mcp
5. 保存并在聊天中启用

然后就可以向 Claude 询问任何有关你业务的问题。

连接到 Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "saas-brain": {
      "type": "http",
      "url": "https://your-render-url.onrender.com/mcp"
    }
  }
}

文件位置：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

重要说明

• 使用 Supabase 的 service_role 密钥（而不是 anon 密钥），以便查询 auth.users
• 流失检测通过匹配 Stripe 和 Supabase 中的邮箱来实现，请确保用户在两者中使用相同的邮箱注册
• Render 免费实例在 15 分钟无活动后会休眠，首次请求可能需要 30 秒唤醒实例

费用

$0，Stripe 测试模式免费，Supabase 免费套餐永久有效，Render 免费套餐足以满足个人使用需求。

许可证

MIT，可免费使用、修改和部署。

作者

Mohd. Kaif Shaikh GitHub