ascope-mcp

ascope-mcp

适用于 Ascope 的 MCP 服务。Ascope 是一款原生 macOS 应用，可追踪 App Store 关键词排名。它让 Cursor、Claude Code、Claude Desktop 和其他任何 MCP 客户端都能查看你的排名、研究关键词并管理追踪内容。

这个软件包是一个轻量级桥接程序：它通过 stdio 与你的助手通信，并将每次调用转发给 Ascope 在你自己的 Mac 上运行的 MCP 服务。数据不会离开你的设备，也不需要 API 密钥。

要求

• macOS 14 Sonoma 或更高版本，并已安装 Ascope 且拥有 Pro 许可证——每年 $89.99，无免费套餐，14 天内可全额退款
• Ascope 已打开，并在 设置 → MCP 中启用了服务
• Node.js 18 或更高版本

安装

Cursor

将以下内容添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "ascope": {
      "command": "npx",
      "args": ["-y", "ascope-mcp"]
    }
  }
}

Claude Code

claude mcp add ascope -- npx -y ascope-mcp

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "ascope": {
      "command": "npx",
      "args": ["-y", "ascope-mcp"]
    }
  }
}

支持通过 Streamable HTTP 使用 MCP 的客户端也可以直接连接到 http://127.0.0.1:47321/mcp，无需此软件包。

工具

工具	功能
list_apps	列出你正在追踪的应用及其关键词数量。
list_keywords	列出某个应用正在追踪的关键词，以及排名、变化、热度、难度和结果数量。
keyword_history	查看某个正在追踪的关键词每日排名历史。
add_keywords	开始追踪关键词，并获取其排名、热度和难度。
remove_keywords	停止追踪关键词。
refresh_rankings	获取某个应用所有或部分关键词的最新排名。
research_keyword	查询任意关键词，无需追踪：查看热度、难度、热门应用和你的排名。
suggest_keywords	根据 App Store 搜索建议获取关键词灵感，并提供热度最高关键词的热度数据。
ranked_keywords	根据缓存的查询结果，查找某个已追踪应用已出现排名、但尚未追踪的关键词。
app_ratings	查看各国家或地区的平均评分、评分数量及每日历史记录。
search_apps	搜索 App Store，查找应用 ID。
similar_apps	查看 App Store 在某个应用旁推荐的应用，也就是它最接近的竞争对手。
add_app	根据 App Store ID 开始追踪应用。

上表列出了 Ascope 提供的工具。即使 Ascope 已关闭，桥接程序仍会保持连接，并提供一个 ascope_setup 工具来说明需要安装什么，因此助手会告诉你缺少什么，而不是报告服务已失效。打开 Ascope 后，真正的工具会自动取代它，无需重启客户端。

可以询问的问题

• “我有哪些关键词本周排名下降了超过 5 位？”
• “为我的应用在德国找到 10 个热度高于 30 且难度低于 50 的关键词，然后开始追踪。”
• “比较我在美国、英国和加拿大的 habit tracker 排名。”
• “研究 budget planner：哪些应用排名靠前，排名难度有多大？”

配置

桥接程序会在 http://127.0.0.1:47321/mcp 查找 Ascope。如果你在“设置 → MCP”中更改了端口，程序会自动识别；你也可以显式设置：

ASCOPE_MCP_URL=http://127.0.0.1:50000/mcp npx -y ascope-mcp

许可证

MIT