mcpField
Q
qveris

qveris

github.com/hqmanAgent 工作流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. 搜索:描述所需的能力(而非具体参数)

    • 好的示例:"weather forecast API"
    • 不好的示例:"get weather for London"
  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 工具

评论

支持 Markdown