Indie Founder Revenue MCP

独立创始人收入 MCP

一个 Model Context Protocol 服务，可将 Lemon Squeezy + Gumroad + Polar + Stripe 的收入汇总到一个可供 Claude 查询的视图中。独立创始人可以问 Claude “我所有商店的 MRR 是多少？”——Claude 只需调用一个工具即可作答，无需在四个浏览器标签页之间切换。

状态： v0.2——四个适配器均已发布。LS + Gumroad 已通过生产环境验证；Polar + Stripe 已通过离线验证（实时测试需要你自己的组织／账户）。免费增值模式：3 个免费工具，3 个付费工具（参见定价）。

向 Claude 提供的工具

工具	级别	功能
summary_mrr(days=30)	免费	所有已连接商店的合并 MRR / ARR，并按提供商细分。
recent_orders(limit=20)	免费	所有商店最近的 N 笔订单，并规范化为统一架构。
health()	免费	各适配器的健康检查——在使用其他工具前很有用。
top_customers(limit=10, days=30)	付费	时间范围内收入最高的客户，按美元总额排序。
refund_signal(days=7, alert_multiplier=2.0)	付费	当前 N 天退款率与前一个 N 天时间段的对比。比率跃升至 ≥2 倍时触发 alert。安全处理零值情况。
export_csv_for_tax(year, quarter)	付费	用于乌克兰 FOP 第 3 组季度申报的 CSV 导出。按订单从 bank.gov.ua 获取 NBU 美元／格里夫纳汇率。

安装（Claude Desktop / Claude Code / Cursor）

在 PyPI 版本发布之前，可通过 uvx 从此 Git 仓库安装：

{
  "mcpServers": {
    "indie-founder": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/charlie-morrison/indie-founder-mcp@main",
        "indie-founder-mcp"
      ],
      "env": {
        "LS_API_TOKEN": "your_lemon_squeezy_token_here",
        "LS_STORE_ID": "optional_store_id_filter",
        "GUMROAD_ACCESS_TOKEN": "optional_gumroad_token",
        "POLAR_API_TOKEN": "optional_polar_token",
        "STRIPE_API_KEY": "optional_stripe_secret_key",
        "INDIE_FOUNDER_MCP_LICENSE_KEY": "optional_license_key_for_paid_tier"
      }
    }
  }
}

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows），然后重启 Claude Desktop。

从 https://app.lemonsqueezy.com/settings/api 获取 Lemon Squeezy API 令牌。

本地克隆安装

git clone https://github.com/charlie-morrison/indie-founder-mcp.git
cd indie-founder-mcp
pip install -e .
indie-founder-mcp  # runs stdio transport

与现有 3 个 LS MCP 的区别

GitHub 上已有三个开源的、仅支持 LS 的 MCP。它们都提供原始 CRUD API 调用。没有一个实现了变现或聚合功能。

此 MCP 的不同之处：

1. 多来源聚合——通过一个查询界面支持 LS + Gumroad + Polar + Stripe（四个适配器均已在 v0.2 中发布）。
2. 独立创始人每日摘要视图——MRR、顶级客户、退款信号、流失风险，而不是照搬原始 API 数据。
3. 用于乌克兰 FOP 报税的 CSV 导出——第三类单一税纳税人需要一种以 NBU 汇率为基准的特定格式。
4. 免费增值模式，包含付费级别——Lemon Squeezy 许可证密钥用于解锁分析和税务导出工具；每日检查工具则永久免费。

生产环境验证

已在作者自己的 charliemorrison.lemonsqueezy.com 商店（商店 ID 344362）和 Gumroad 真实账户上构建并验证：

• health → 针对各提供商的 /users/me 等效接口返回 {"lemonsqueezy": true, "gumroad": true}。
• recent_orders → 返回 2026-05-07 来自 [email protected] 的真实 $17 Social Media AI Mastery LS 订单，并规范化为与 Gumroad 订单相同的架构。
• summary_mrr → MRR 为 $0（正确——这些商店尚无订阅转化；已验证该工具对 active/trialing/past_due 状态的处理流程）。
• top_customers(limit=5, days=90) → 按所有已接入提供商的客户终身美元消费额排序。
• refund_signal(days=7) → 对经营状况良好的新商店，零值情况下返回 alert=False。
• export_csv_for_tax(2026, 2) → 返回一行：2026-05-07,lemonsqueezy,8274123,[email protected],Social Media AI Mastery,17.00,0.00,17.00,43.8528,745.50,745.50——汇率实时取自 bank.gov.ua。

Polar + Stripe 适配器已通过离线验证（四个适配器的 24 项 fixture 测试均通过）。要对这两者进行实时验证，需要用户自己的 Polar 组织／Stripe 账户——设置相应环境变量后，适配器会自动接入。

定价

层级	价格	工具
免费	$0	summary_mrr、recent_orders、health — 日常检查流程。商店数量不限。
付费	$19/mo 或 $190/yr（免费赠送 2 个月）	免费版的所有工具，另外还包括 top_customers、refund_signal、export_csv_for_tax（分析功能 + 乌克兰 FOP CSV 导出）。

购买许可证：https://charliemorrison.lemonsqueezy.com → 将密钥填入 INDIE_FOUNDER_MCP_LICENSE_KEY，然后重启 MCP 主机。

免费工具永远不会检查许可证——不会突然撤回。付费版只是面向有此需求的用户提供分析和导出功能。

许可证与变现方案

• 代码：MIT（开放的服务；付费功能在运行时通过 Lemon Squeezy 许可证密钥进行授权）。
• 许可证密钥：Lemon Squeezy License API（/v1/licenses/validate），验证缓存 6 小时。
• 收款：LS → Wise USD（已验证——通过试用商店到账 $17）。

构建计划

分阶段构建顺序请参见 PLAN.md。v0.2 将推出全部四个适配器、许可证验证机制和 6 个工具（3 个免费、3 个付费）。

项目缘起

每天早上，我都要打开四个控制面板标签页（Lemon Squeezy、Gumroad、Polar、Stripe）查看 MRR 和近期订单，然后还得在电子表格里重新计算同样的数据，以便申报 FOP 税款。于是我请 Claude 把这些整合起来。这就是成果——现在 Claude 会自行完成每天早上的检查。

---

由 Charlie Morrison 构建。欢迎提交问题和 PR。