npm-trends-mcp

面向AI助手的npm包趋势数据 追踪任意npm包的每周下载量。包下载趋势能够揭示开发者正在采用哪些JavaScript库和框架、哪些正在失势、以及生态系统的未来走向。

完整文档和在线演示： https://trendsmcp.ai/npm-trends

属于 Trends MCP 的一部分 —— 提供来自12+来源的实时趋势数据的MCP服务器。 查看主仓库：https://github.com/trendsmcp/trends-mcp

快速入门（两步完成）

第一步： 在 trendsmcp.ai 免费获取API密钥 每天100次请求，无需信用卡。

第二步： 添加到你的AI客户端（替换YOUR_API_KEY）：

+ 添加至Cursor（一键操作）

Cursor / Windsurf / Cline   （~/.cursor/mcp.json 或等效文件）

{
  "mcpServers": {
    "trends-mcp": {
      "url": "https://api.trendsmcp.ai/mcp",
      "transport": "http",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code / GitHub Copilot   （.vscode/mcp.json）

{
  "servers": {
    "trends-mcp": {
      "type": "http",
      "url": "https://api.trendsmcp.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktop   （claude_desktop_config.json） 用户 → 设置 → 开发者 → 编辑配置 —— 添加到 mcpServers 中

{
  "mcpServers": {
    "trends-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.trendsmcp.ai/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude.ai（浏览器） Settings -> Connectors -> Add custom connector:

https://api.trendsmcp.ai/mcp

Related MCP server: npm-trends-mcp

示例查询

连接后，向你的AI提问：

get_trends(keyword='react', source='npm', data_mode='weekly')

可用工具

常见问题

Trends MCP 返回哪些npm数据？

返回任意npm包的每周下载量，标准化为0-100的分数，同时包含原始下载量、标准周期（7天、1个月、3个月、1年）的增长率，以及最长可达5年的历史时间序列数据。

如何查询特定包？

请使用准确的npm包名称 —— 例如'react'、'lodash'、'express'或'@anthropic-ai/sdk'。作用域包使用@org/package格式。

能否比较多个包？

可以。使用get_growth并传入逗号分隔的包名，或分别为每个包调用get_trends并比较标准化后的序列。在框架比较中尤为实用，如React vs Vue vs Svelte。

npm数据对投资研究有何价值？

npm下载趋势是开发者生态系统采用情况的领先指标。某个库下载量快速增长，往往预示着其底层平台或框架即将迎来更广泛的商业应用。

npm下载数据如何标准化？

原始周下载量会根据包自身的历史峰值标准化为0-100的得分。这使得即使下载量绝对值差异巨大的不同包之间，也能够比较采用速度。

所有数据来源

Trends MCP 一次连接覆盖12+来源： 谷歌搜索、YouTube、TikTok、Reddit、亚马逊、维基百科、 新闻情绪、网站流量、应用下载、Steam、npm等。

浏览全部：https://trendsmcp.ai/data-sources

同样支持作为Python客户端使用

相同的API密钥可直接在Python中使用 —— 无需MCP主机。

pip install npm-trends-mcp

import os
from npm_trends_mcp import TrendsMcpClient, SOURCE

client = TrendsMcpClient(api_key=os.environ["TRENDSMCP_API_KEY"])

series  = client.get_trends(source=SOURCE, keyword="your keyword")
growth  = client.get_growth(source=SOURCE, keyword="your keyword", percent_growth=["1M", "3M", "12M"])
top     = client.get_top_trends(type="Npm", limit=10)

完整Python文档：trendsmcp.ai/docs

许可证

MIT © Trends MCP