@qverisai/mcp 是面向 Cursor、Claude Desktop 及其他编程 Agent 等 MCP 兼容客户端的官方 QVeris MCP 服务器。
它通过三个 MCP 工具为 Agent 提供 QVeris 访问能力：
discover — 用自然语言发现能力inspect — 获取工具详情（参数、成功率、示例）call — 执行工具并传入参数换言之，MCP 服务器是本仓库其他文档所描述的 QVeris 核心协议的 Agent 侧传输层。
适合使用 MCP 服务器的场景：
适合使用 REST API 的场景：
两种方式均映射到同一套 QVeris 协议：
| 协议操作 | MCP 工具 | REST API |
|---|---|---|
| 发现 | discover | POST /search |
| 检查 | inspect | POST /tools/by-ids |
| 调用 | call | POST /tools/execute |
注意： 旧工具名称（
search_tools、get_tools_by_ids、execute_tool）仍作为弃用别名支持。
18+QVERIS_API_KEYnpx 安装npx -y @qverisai/mcp
MCP 服务器从以下环境变量读取配置：
QVERIS_API_KEY=your-api-key # 必填
QVERIS_REGION=cn # 可选：强制区域（global | cn）
QVERIS_BASE_URL=https://... # 可选：覆盖 API 地址
区域从 API key 前缀自动检测（sk-cn-xxx → 中国区，sk-xxx → 全球）。仅在需要覆盖时设置 QVERIS_REGION。
{
"mcpServers": {
"qveris": {
"command": "npx",
"args": ["-y", "@qverisai/mcp"],
"env": {
"QVERIS_API_KEY": "your-api-key-here"
}
}
}
}
{
"mcpServers": {
"qveris": {
"command": "npx",
"args": ["-y", "@qverisai/mcp"],
"env": {
"QVERIS_API_KEY": "your-api-key-here"
}
}
}
}
中国大陆用户可添加 QVERIS_REGION 或使用 sk-cn- 前缀的 key：
{
"mcpServers": {
"qveris": {
"command": "npx",
"args": ["-y", "@qverisai/mcp"],
"env": {
"QVERIS_API_KEY": "sk-cn-your-api-key-here",
"QVERIS_REGION": "cn"
}
}
}
}
各环境的详细配置指南，请参考：
discover使用自然语言发现能力。
这是**发现（Discover）**操作，免费使用。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
query | string | 是 | 用自然语言描述所需能力 |
limit | number | 否 | 最大返回数量（1-100，默认 20） |
session_id | string | 否 | 用于追踪的会话标识符 |
示例：
{
"query": "weather forecast API",
"limit": 10
}
典型响应字段：
search_idtotalresults[]results[].tool_idresults[].paramsresults[].examplesresults[].statsinspect在复用或调用之前，检查一个或多个已知 tool_id 的详情。
这是**检查（Inspect）**操作。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
tool_ids | array | 是 | 要查询的工具 ID 数组 |
search_id | string | 否 | 返回该工具的发现操作的搜索 ID |
session_id | string | 否 | 用于追踪的会话标识符 |
示例：
{
"tool_ids": ["openweathermap.weather.execute.v1"],
"search_id": "YOUR_SEARCH_ID"
}
以下情况建议使用 inspect：
响应 schema 与 /search 一致，包含所请求工具的参数、示例和统计数据。
call调用已发现的 QVeris 能力。
这是**调用（Call）**操作，每次调用消耗 1–100 积分，按数据和任务价值计费。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
tool_id | string | 是 | 来自发现结果的工具 ID |
search_id | string | 是 | 发现该工具的搜索 ID |
params_to_tool | object | 是 | 传递给工具的参数字典 |
session_id | string | 否 | 用于追踪的会话标识符 |
max_response_size | number | 否 | 最大响应字节数（默认 20480） |
示例：
{
"tool_id": "openweathermap.weather.execute.v1",
"search_id": "YOUR_SEARCH_ID",
"params_to_tool": {"city": "London", "units": "metric"}
}
典型成功响应字段：
execution_idtool_idsuccessresult.dataelapsed_time_ms 或 execution_timecost对于超大输出，QVeris 可能返回：
truncated_contentfull_content_file_urlmessage对于大多数 Agent 任务，建议使用以下流程：
discover — 发现相关能力inspect — 在需要时检查最佳候选call — 调用所选能力实践中：
tool_id 时，建议先重新检查再复用在单次用户会话中提供一致的 session_id 有助于：
若省略 session_id，MCP 服务器可能会在进程存活期间自动生成一个。
node --versionQVERIS_API_KEY 设置正确tool_id 来自此前的发现结果get_tools_by_ids 检查工具后再调用params_to_tool 是否为有效对象如果在某些客户端中直接执行 npx 失败，用 cmd /c 包裹：
{
"command": "cmd",
"args": ["/c", "npx", "-y", "@qverisai/mcp"]
}