ChartMogul的MCP服务器

支持的工具

账户与数据源

• retrieve_account - 获取账户信息
• list_sources - 列出所有数据源（可选过滤）
• retrieve_source - 根据UUID获取特定的数据源

客户管理

• list_customers - 列出客户（可选过滤）
• search_customers - 按电子邮件搜索客户
• retrieve_customer - 根据UUID获取客户
• create_customer - 创建新客户
• update_customer - 更新客户属性
• list_customer_subscriptions - 获取客户的订阅
• list_customer_activities - 获取客户活动
• list_customer_attributes - 获取客户属性
• add_customer_tags - 向客户添加标签
• add_customer_custom_attributes - 向客户添加自定义属性

联系人

• list_contacts - 列出所有联系人
• retrieve_contact - 根据UUID获取联系人
• create_contact - 创建新的联系人
• update_contact - 更新联系人信息

客户备注

• list_customer_notes - 列出客户备注和通话记录
• retrieve_customer_note - 根据UUID获取特定的备注
• create_customer_note - 创建新的备注或通话记录
• update_customer_note - 更新现有的备注

销售与CRM

• list_opportunities - 列出销售机会
• retrieve_opportunity - 根据UUID获取机会
• create_opportunity - 创建新的销售机会
• update_opportunity - 更新销售机会详情
• list_tasks - 列出客户任务
• retrieve_task - 根据UUID获取任务
• create_task - 创建新的任务
• update_task - 更新任务信息

计划

• list_plans - 列出订阅计划
• retrieve_plan - 根据UUID获取计划
• create_plan - 创建新的计划
• update_plan - 更新计划详情
• list_plan_groups - 列出计划组
• retrieve_plan_group - 根据UUID获取计划组
• create_plan_group - 创建新的计划组
• update_plan_group - 更新计划组
• list_plan_group_plans - 列出组内的计划

分析与指标

• all_metrics - 获取所有关键指标（MRR、ARR、ARPA、ASP、客户数量、流失率、LTV）
• mrr_metrics - 获取每月经常性收入指标
• arr_metrics - 获取年度运行率指标
• arpa_metrics - 获取每个账户平均收入指标
• asp_metrics - 获取平均售价指标
• customer_count_metrics - 获取客户数量指标
• customer_churn_rate_metrics - 获取客户流失率指标
• mrr_churn_rate_metrics - 获取MRR流失率指标
• ltv_metrics - 获取客户生命周期价值指标

数据操作

• list_subscription_events - 列出订阅事件
• create_subscription_event - 创建新的订阅事件
• update_subscription_event - 更新订阅事件详情
• list_invoices - 列出发票（可选过滤）
• import_invoices - 创建新的发票
• retrieve_invoice - 根据UUID获取发票
• list_activities - 列出业务活动（新业务、扩展、流失等）

使用方法

1. 打开位于以下位置的Claude Desktop配置文件：

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

2. 添加以下内容：

{
  "mcpServers": {
    "mcp-chartmogul": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/local/chartmogul-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "CHARTMOGUL_TOKEN": "<YOUR-CHARTMOGUL-TOKEN>"
      }
    }
  }
}

3. 运行which uv以定位uv命令条目，并将其替换为uv可执行文件的绝对路径。

4. 重启Claude Desktop以应用更改。

开发

1. 在仓库根目录下运行cp example.env .env以创建一个.env文件。

2. 使用以下环境变量更新它。

CHARTMOGUL_TOKEN=<YOUR-CHARTMOGUL-TOKEN>

3. 按照这里的说明安装uv。

4. 运行uv sync以安装依赖项。

5. 运行source .venv/bin/activate以激活创建的虚拟环境。

6. 运行mcp dev main.py:cm_mcp以启动开发MCP服务器。此命令需要Node.js和npm的安装。

7. 在http://127.0.0.1:6274检查并连接到MCP服务器。