订阅分析服务器

GrowPanel MCP Server是一个用于订阅分析的服务器,通过模型上下文协议连接AI助手与GrowPanel数据,提供报告、客户、计划、设置等14种工具。

  • by growpanel
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 growpanel/growpanel-mcp-server

使用说明

GrowPanel MCP服务器

MCP服务器 GrowPanel 订阅分析。通过模型上下文协议将AI助手(Claude、Cursor、Windsurf等)连接到GrowPanel数据。

14工具 涵盖报告、客户、计划、设置、webhooks、计费、团队等。加上一个通用的API直通,自动支持新的API功能。

安装

npm install -g @growpanel/mcp-server

配置

克劳德桌面版

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):

{
    "mcpServers": {
        "growpanel": {
            "command": "growpanel-mcp",
            "env": {
                "GROWPANEL_API_KEY": "your-api-key-here"
            }
        }
    }
}

游标/其他MCP客户端

大多数MCP客户端支持类似的配置。将命令设置为 growpanel-mcp 并提供 GROWPANEL_API_KEY 环境变量。

环境变量

变量 描述 默认值
GROWPANEL_API_KEY GrowPanel API密钥(必需) -
GROWPANEL_API_URL API基本URL https://api.growpanel.io

为了向后兼容性, GROWPANEL_API_TOKEN 也被接受。

获取API密钥: app.growpanel.io → 设置→ API密钥。

可用工具

分析

工具 说明
get_report 按名称获取任何分析报告(mrr、摘要、队列、潜在客户、现金流等)

这 get_report 工具接受任何报表名称-添加到API的新报表将自动工作。

已知报告: mrr、mrr表、摘要、cmrr摘要、移动表、映射、队列、潜在客户、潜在客户表、潜在客户天数、潜在客户摘要、交易、交易表、交易详细信息、交易摘要、发票详细信息、计划流失、计划流失移动、计划流失摘要、客户集中度、现金流失败付款、现金流错误付款摘要、现金流退款、现金流退还表、现金流故障率、未付未付现金流、自定义变量

客户和计划

工具 说明
list_customers 列出具有MRR和订阅详细信息的客户
get_customer 获取特定客户的详细信息
resync_customer 从支付提供商触发数据重新同步
list_plans 列出所有订阅计划和计划组

数据管理

工具 说明
manage_data 对客户、计划、计划组、数据源、发票的CRUD操作
export_csv 将客户或MRR移动导出为CSV

设置和集成

工具 说明
manage_settings 获取/更新帐户和集成设置
manage_webhooks 管理webhook订阅(列表、创建、删除、验证、示例)

账户管理

工具 说明
manage_account 获取、更新或删除帐户
manage_billing 账单明细、发票、订阅、付款方式
manage_team 团队成员:列表、邀请、编辑角色、删除
manage_api_keys API密钥管理:列表、创建、更新、删除

通用通道

工具 说明
api_request 直接调用任何API端点(方法+路径+参数/body)

这 api_request 工具支持任何API端点。GrowPanel API中添加的新功能可立即通过此工具获得,而无需MCP服务器更新。

示例提示

连接后,您可以询问您的AI助手:

  • “我现在的MRR是什么?”
  • “显示过去6个月的MRR趋势”
  • “按收入列出我的主要客户”
  • “我的流失率是多少?”
  • “显示队列保留分析”
  • “本季度转换了多少线索?”
  • “列出我的所有webhook订阅”
  • “我当前的设置是什么?”

自更新架构

MCP服务器使用与 GrowPanel命令行界面:

  • get_report 接受任何报告名称并将其传递给 /reports/<name>。新报告会自动工作。
  • api_request 可以调用任何API端点。新的API功能在第一天工作。
  • 命名工具(manage_data, manage_settings等)为AI理解提供了更好的描述,但直通确保了没有遗漏任何内容。

发展

npm install
npm run dev          # Run from source via tsx
npm run build        # Compile TypeScript
npm run typecheck    # Type checking only
npm start            # Run built version

需求

  • Node.js 20+
  • 具有API密钥的GrowPanel帐户

许可证

麻省理工学院