ToolScope

Scanne jedes Tool auf deinem Mac und mach es für Menschen und KI-Agenten abfragbar.

ToolScope erfasst die auf deiner Maschine installierten GUI-Anwendungen und CLI-Tools – via Homebrew, npm, pipx, uv, /Applications und $PATH – in einer lokalen SQLite-Datenbank. Du kannst sie nach Fähigkeiten durchsuchen, für die Aufräumaktionen prüfen oder von einem KI-Agenten über MCP abfragen. Read-only: Es deinstalliert nie etwas.

Warum

• Du vergisst, was du installiert hast. Jahre aus brew install, npm install -g und pipx install hinterlassen Hunderte Einträge; brew list ist eine Textwand ohne Nutzsignal.

• Du erinnerst dich an die Aufgabe, nicht an den Namen des Tools. Du willst „Video transkodieren“, kommst aber nicht darauf, dass es ffmpeg ist. ToolScope durchsucht Beschreibungen und KI‑generierte Fähigkeitsnotizen, nicht nur Namen.

• KI-Agenten können deine Maschine nicht sehen. Wenn ein Coding-Agent eine Aufgabe übernimmt, hat er keine strukturierte Antwort auf „Was kann dieser Mac?“. ToolScope beantwortet das in einem einzigen MCP‑Tool‑Call.

Related MCP server: WEATHGARDS

Funktionen

• Einmaliger Scan von sechs Quellen in SQLite unter ~/.toolscope/toolscope.db; erneute Scans machen ein UPSERT vor Ort und erhalten first_seen

• Fähigkeitssuche über Namen, manuell geschriebene Beschreibungen und KI‑generierte Beschreibungen

• Nutzungsverfolgung durch einen idempotenten „zsh preexec“‑Hook (usage.count, usage.last_used), damit du weißt, was wirklich tot ist

• Lokales Web‑Dashboard (React + TypeScript, ohne UI-Framework): sechs Ansichten – Übersichtskarten, durchsuchbare Werkzeugliste, ungenutzte Ansicht, Nutzungsstatistik (Top 20 + 30‑Tage‑Trend), Erstanleitung und LLM-Einstellungen – plus ⌘K‑Befehlspalette und „Detail Drawer“

• stdio‑MCP‑Server mit drei Tools für die KI‑Agenten‑Integration

• Brewfile-Export für die Migration auf eine andere Maschine

• Umgebungs‑Selbstcheck über den Befehl doctor

• Optionales, einzeiliges chinesisches Fähigkeitsprofil, generiert über einen beliebigen OpenAI‑kompatiblen Endpunkt; Anbieter/Modell/Schlüssel im Dashboard‑Tab „Einstellungen“ oder über toolscope config konfigurierbar (lokal mit 0600 gespeichert, keine Umgebungsvariablen nötig)

• Optionale schlanke Electron‑Hülle um das Dashboard

Schnellstart

Erfordert macOS und Python 3.12+.

pipx install toolscope
toolscope scan                  # ~13s; prints per-source counts; missing sources count 0
toolscope list                  # everything recorded so far
toolscope search video --json   # capability search; parseable JSON envelope
toolscope serve                 # dashboard at http://127.0.0.1:8421

CLI‑Referenz

Listenbefehle geben standardmäßig menschenlesbaren Text aus und mit --json das JSONevelope {"items": [...], "total": N}.

Nutzungsverfolgung:

toolscope hook-install   # run once; new shells log each command to ~/.toolscope/usage.log

Maschinenmigration:

toolscope scan
toolscope export --out Brewfile
brew bundle --file=Brewfile

Für KI-Agenten

Fürb zwei Integrationsflächen mit dem gleichen JSON‑Vertrag.

CLI. Listenbefehle unterstützen --json und geben {"items": [...], "total": N} aus; Einzel‑Objekt‑Befehle geben das Objekt direkt aus. Ein Tool‐Objekt enthält id, name, kind, version, path, origin, description, ai_description, usage:{count,last_used}|null.

toolscope search video --json
toolscope info ffmpeg --json
toolscope stats --json

HTTP‑API. toolscope serve gibt dieselben Daten per JSON auf 127.0.0.1:8421 aus, alle Listen‑Endpunkte liefern das Obige Envelope: /api/tools, /api/tools/{id}, /api/search?q=, /api/stats, /api/usage/log, /api/usage/stats, /api/export (Brewfile‑Download), /api/doctor, /api/hook/snippet und POST /api/scan. LLM‑Einstellungen lassen sich auch von Agenten aus verwalten: GET/PUT /api/settings, GET /api/settings/providers, POST /api/settings/test. API‑Schlüssel werden immer nur maskiert zurückgegeben, nie in Klartext.

MCP. Zuerst das Extra installieren: pipx install "toolscope[mcp]". Dann registriere den Server bei deinem Client – im Stil der mcpServers-Konfiguration von Claude Desktop:

{
  "mcpServers": {
    "toolscope": {
      "command": "toolscope",
      "args": ["mcp"]
    }
  }
}

Es stehen drei Tools zur Verfügung:

• search_tools(query, kind?) – Fähigkeitssuche („kann diese Maschine Zeichen das?“); liefert das Obige Envelope

• get_tool(name) – einzelnes Tool-Objekt, oder den wörtlichen Text null, wenn nicht gefunden (ein normales Ergebnis, kein Fehler)

• machine_stats() – {total, by_kind, never_used}

Screenshots

Platzhalter bis zum ersten vollständigen Screenshot einer ganzen Maschine – geplante Aufnahmen sind in docs/screenshots.md gelistet.

So funktioniert es

scan erfasst Daten von sechs Quellen und macht ein UPSERT über (name, kind, origin) in SQLite unter ~/.toolscope/. Einträge, die später aus dem System verschwinden, werden behalten, nicht gelöscht.

Eine Quelle, deren Manager‑Binär fehlt, bringt den Scan nie zum Scheitern; sie wird als übersprungen mit Anzahl 0 gemeldet.

Entwicklung

git clone <repo-url> && cd toolscope
python3.12 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
python -m pytest -q                              # backend suite must be green
cd frontend && npm install && npm run build      # dashboard build; tsc must be clean
cd .. && toolscope serve                         # serves frontend/dist at :8421

Optionale Desktop‑Shell: siehe desktop/ (npm install && npm start).

Lizenz

MIT

中文说明

中文说明翻译请愿

ToolScope 把 Mac 上经年久月装下的几十 GUI 应用与上百 CLI 工具收进一个本地 SQLite（~/.toolscope/），回答三个问题：我装过什么 / 它能干嘛 / 我用过没。该工具以纯读方式运行，绝不卸载的。

pipx install toolscope            # 需 MCP 时：pipx install "toolscope[mcp]"
toolscope scan                    # 全量扫描六来源，输出各来源计数；缺失来源计 0 跳过
toolscope search 视频 --json      # 能力搜索：跨名称与描述匹配，支持中文关键词
toolscope serve                   # 浏览器打开 http://127.0.0.1:8421 看板
toolscope config                  # 可选：配置 LLM 供应商/模型/Key（看板「设置」页签同源，Key 打码 0600 存储）
toolscope hook-install            # 可选：安装 zsh 钩子记录使用度（幂等）
toolscope export --out Brewfile   # 迁移新机时配合 brew bundle 还原环境

Dashboard 包含六个视图（概览 / 列表 / 未使用 / 使用统计 / 引导 / 设置）、⌘K 命令面板与详情抽屉。AI Agent 接入见上文 For AI­Agent：CLI 全部命令支持 --json 信封式输出; HTTP API 涵盖同一数据层（: /api/tools、/api/search?q=、/api/usage/stats、/api/settings 等）；或按 mcpServers 写法将 toolscope mcp 注册为 stdio‑MCP‑Server（三个工具：search_tools / get_tool / machine_stats）。许可证 MIT。