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/。新报告会自动工作。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帐户
许可证
麻省理工学院
