ascope-mcp

ascope-mcp

Ascope 用の MCP サーバーです。App Store のキーワードランキングを追跡する macOS ネイティブアプリです。Cursor、Claude Code、Claude Desktop、その他の MCP クライアントから、ランキングの確認、キーワードの調査、追跡対象の管理ができます。

このパッケージは小さなブリッジです。アシスタントとは stdio で通信し、すべての呼び出しを、お使いの Mac 上で Ascope が実行する MCP サーバーに転送します。データがマシンの外に送信されることはなく、API キーも必要ありません。

必要条件

• Ascope がインストールされた macOS 14 Sonoma 以降と Pro ライセンス — 年額 $89.99、無料プランはありません。14 日以内であれば全額返金されます
• Ascope を起動し、Settings → 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	追跡中のキーワード1件の日次順位履歴を表示します。
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つ以上下がったキーワードはどれですか？」
• 「ドイツで、自分のアプリに適した人気度が30を超え、難易度が50未満のキーワードを10個見つけて、追跡を開始してください。」
• 「米国、英国、カナダで habit tracker の順位を比較してください。」
• 「budget planner を調査してください。上位アプリはどれで、ランクインするのはどれくらい難しいですか？」

設定

ブリッジは http://127.0.0.1:47321/mcp で Ascope を検出します。Settings → MCP でポートを変更した場合は自動的に反映されます。明示的に設定することもできます。

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

ライセンス

MIT