@umengfe/mcp-server-umeng-openapi

@umengfe/mcp-server-umeng-openapi

友盟MCP (Model Context Protocol) API的Node.js客户端库，提供了一系列友盟统计数据API的封装。

安装

npm install @umengfe/mcp-server-umeng-openapi

在cursor中配置

在cursor的mcp.json文件中添加以下内容：

{
	"mcpServers": {
		"umeng-openapi": {
			"command": "npx",
			"args": [
        "-y",
        "@umengfe/mcp-server-umeng-openapi"
			],
			"env": {
				"UMENG_API_KEY": "xxx",
				"UMENG_API_SECRET": "xxx"
			}
		}
	}
}

在window上，需要添加单独的配置

{
  "mcpServers": {
    "umeng-openapi": {
          "command": "cmd",
          "args": [
            "/c",
            "npx",
            "-y",
            "@umengfe/mcp-server-umeng-openapi"
          ],
          "env": {
            "UMENG_API_KEY": "xxx",
            "UMENG_API_SECRET": "xxx"
          }
        }
  }
}

友盟OpenAPI签名辅助工具

该库提供了一个签名辅助工具，输入API密钥和API安全密钥，填写函数和参数，生成签名后的请求URL。

import UmengOpenAPI from '@umengfe/mcp-server-umeng-openapi/dist/src/umopenapi.js';
const client = new UmengOpenAPI('your_api_key','your_api_security');
const signedUrl = client.generateSignedUrl('param2/1/com.umeng.uapp/umeng.uapp.getAllAppData', {a:1,b:2});
fetch(signedUrl).then(res => res.json()).then(data => console.log(data));

API文档

友盟统计数据

获取所有应用的统计数据。

// 返回数据示例（数字仅供参考）
{
  "allAppData": [
    {
      "yesterdayNewUsers": 1234,        // 昨日新增用户
      "yesterdayUniqNewUsers": 1234,    // 昨日独立新增用户
      "todayLaunches": 5000,            // 今日启动次数
      "totalUsers": 100000,             // 总用户数
      "todayNewUsers": 500,             // 今日新增用户
      "yesterdayUniqActiveUsers": 2000,  // 昨日独立活跃用户
      "todayActivityUsers": 1500,        // 今日活跃用户
      "yesterdayLaunches": 4800,         // 昨日启动次数
      "yesterdayActivityUsers": 2100     // 昨日活跃用户
    }
  ]
}

许可证

MIT

更新日志

[1.0.6] - 2025-05-20

修复

• 修复了参数提取序列化错误的问题

[1.0.5] - 2025-05-19

新增

• 获取事件参数值时长列表。
• 获取App今天与昨天的统计数据。
• 获取App昨天统计数据。
• 获取App今天统计数据。
• 获取自定义事件的独立用户数。
• 获取渠道维度统计数据。
• 获取版本维度统计数据。
• 获取事件参数值统计数据。
• 获取事件参数值列表。
• 获取自定义事件的统计数据。
• 获取事件参数列表。
• 获取事件列表。
• 获取App新增用户留存率。
• 获取App使用时长。
• 获取App启动次数。
• 获取App活跃用户数。
• 获取App新增用户数。
• 获取App统计数据。
• 创建自定义事件。

[1.0.4] - 2025-05-12

新增

• 获取单个应用的新增账号。
• 获取单个应用的活跃账号。
• 根据渠道或版本条件，获取App启动次数。
• 根据渠道或版本条件，获取App活跃用户数。
• 根据渠道或版本条件，获取App新增用户数。

[1.0.3] - 2025-10-06

新增

• 新增获取全部应用数量的能力。
• 新增获取应用列表的能力。

常见问题 (FAQ)

• 如何获取 UMENG_API_KEY 和 UMENG_API_SECRET？ 请访问友盟开发者平台的开放API状态页面以获取相关信息。