mcpField
Q
qveris

qveris

github.com/hqmanエージェントワークフロー3484 回インストール39 週間前に更新
リポジトリ

qveris について

QVerisは、機能に基づいてツールを検索し、選択したツールをパラメーター付きで実行するスキルです。QVeris APIを使ったコマンドラインの手順で、検索、結果の比較、実行を行えます。

主な機能

  1. 01機能によるツール検索
  2. 02パラメーター付きのツール実行
  3. 03成功率と実行時間の確認
  4. 04検索結果数の指定

活用シーン

  1. 01現在の天気や予報の取得
  2. 02株価データや決算カレンダーの照会
  3. 03ウェブ検索、ニュース、データAPI用ツールの検索

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hqman/qveris --skill qveris

インストール後、Claude Code で/qverisを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
README.md
README.zh-CN.md
pyproject.toml
scripts/
qveris_tool.py

詳細

QVeris ツール検索と実行

QVeris は、ツールの動的な発見と実行を提供します。機能でツールを検索し、パラメーターを指定して実行できます。

セットアップ

環境変数が必要です:

クイックスタート

ツールを検索する
uv run scripts/qveris_tool.py search "weather forecast API"
ツールを実行する
uv run scripts/qveris_tool.py execute openweathermap_current_weather --search-id <id> --params '{"city": "London", "units": "metric"}'

スクリプトでの使用方法

scripts/qveris_tool.py <command> [options]

Commands:
  search <query>     Search for tools matching a capability description
  execute <tool_id>  Execute a specific tool with parameters

Options:
  --limit N          Max results for search (default: 5)
  --search-id ID     Search ID from previous search (required for execute)
  --params JSON      Tool parameters as JSON string
  --max-size N       Max response size in bytes (default: 20480)
  --json             Output raw JSON instead of formatted display

ワークフロー

  1. 検索:必要な機能を説明します(具体的なパラメーターではありません)

    • 良い例:「天気予報 API」
    • 悪い例:「ロンドンの天気を取得する」
  2. 選択:success_rate と avg_execution_time を基にツールを確認します

  3. 実行:tool_id、search_id、parameters を指定してツールを呼び出します

セッション例

# Find weather tools
uv run scripts/qveris_tool.py search "current weather data"

# Execute with returned tool_id and search_id
uv run scripts/qveris_tool.py execute openweathermap_current_weather \
  --search-id abc123 \
  --params '{"city": "Tokyo", "units": "metric"}'

ユースケース

  • 気象データ:任意の場所の現在の天気や予報を取得します
  • 株式市場:株価、過去のデータ、決算カレンダーを照会します
  • 検索:ウェブ検索、ニュース取得
  • データ API:為替、位置情報、翻訳
  • その他:QVeris は数千もの API ツールを集約しています

コメント