QVeris
工程实践 · 教程

通过 MCP 将 QVeris 接入 Cursor

连接 QVeris MCP 与 Cursor,在 IDE 内发现、检查并调用经过验证的 API。

发布日期:2026年3月7日 · QVeris团队制作

Cursor — project
📁 src
📁 components
📄 index.ts
📄 dashboard.tsx
获取当前 AAPL 股价,并将其添加到仪表盘
我会为您获取实时股票数据。
🔧 QVeris → finance.stock_quote
✓ 已在 320ms 内执行
const stockData = {
symbol: "AAPL", price: 198.52,
change: +2.31, timestamp: "2026-03-25T14:32:07Z"
};

为什么将 QVeris 连接到 Cursor?为什么将 QVeris 连接到 Cursor?为什么将 QVeris 连接到 Cursor?

✗ 未接入 QVeris✗ 未接入 QVeris✗ 未接入 QVeris
  • AI 只能理解您的代码库AI 只能理解您的代码库AI 只能理解您的代码库
  • 无法访问实时数据或外部 API无法访问实时数据或外部 API无法访问实时数据或外部 API
  • 每项集成都要自行编写样板代码每项集成都要自行编写样板代码每项集成都要自行编写样板代码
  • AI 只能根据训练数据猜测 API 响应AI 只能根据训练数据猜测 API 响应AI 只能根据训练数据猜测 API 响应
  • 每增加一个数据源,都要重新做集成每增加一个数据源,都要重新做集成每增加一个数据源,都要重新做集成
✓ 接入 QVeris✓ 接入 QVeris✓ 接入 QVeris
  • AI 可按需发现 10,000 多个真实 APIAI 可按需发现 10,000 多个真实 APIAI 可按需发现 10,000 多个真实 API
  • 在 IDE 中访问实时股票、加密货币、天气和新闻在 IDE 中访问实时股票、加密货币、天气和新闻在 IDE 中访问实时股票、加密货币、天气和新闻
  • 无需样板代码,认证和路由由 QVeris 处理
  • 使用真实 API 响应,而不是训练数据猜测使用真实 API 响应,而不是训练数据猜测使用真实 API 响应,而不是训练数据猜测
  • 一条自然语言请求即可调用新能力一条自然语言请求即可调用新能力一条自然语言请求即可调用新能力

QVeris 通过 MCP Server 连接 Cursor,这也是 Cursor 集成各类工具所使用的协议。整个设置不到 5 分钟。QVeris 通过 MCP Server 连接 Cursor,这也是 Cursor 集成各类工具所使用的协议。整个设置不到 5 分钟。QVeris 通过 MCP Server 连接 Cursor,这也是 Cursor 集成各类工具所使用的协议。整个设置不到 5 分钟。

QVeris 在 Cursor 内部如何工作

💬

向 Cursor 提出请求向 Cursor 提出请求向 Cursor 提出请求

在 Cursor AI 聊天中输入请求:
“获取当前比特币价格,并按我的仪表盘格式整理”“获取当前比特币价格,并按我的仪表盘格式整理”“获取当前比特币价格,并按我的仪表盘格式整理”

→
🔀

QVeris MCP 完成路由QVeris MCP 完成路由QVeris MCP 完成路由

Cursor 把请求发送给 QVeris;QVeris 随即发现最合适的能力、检查参数,并通过经过验证的提供商执行。Cursor 把请求发送给 QVeris;QVeris 随即发现最合适的能力、检查参数,并通过经过验证的提供商执行。Cursor 把请求发送给 QVeris;QVeris 随即发现最合适的能力、检查参数,并通过经过验证的提供商执行。

→
✓

返回实时数据返回实时数据返回实时数据

结构化 JSON 返回 Cursor,AI 使用实时数据完成任务,得到的是真实数值,而不是基于训练数据的估算。结构化 JSON 返回 Cursor,AI 使用实时数据完成任务,得到的是真实数值,而不是基于训练数据的估算。结构化 JSON 返回 Cursor,AI 使用实时数据完成任务,得到的是真实数值,而不是基于训练数据的估算。

在 Cursor 中设置 QVeris:分步教程

整个过程不到 5 分钟,无需信用卡。整个过程不到 5 分钟,无需信用卡。整个过程不到 5 分钟,无需信用卡。

01

获取 QVeris API 密钥获取 QVeris API 密钥获取 QVeris API 密钥

在 qveris.ai 注册免费账户即可获得 1,000 积分,无需信用卡。进入“账户 → API 密钥 → 创建新密钥”。在 qveris.ai 注册免费账户即可获得 1,000 积分,无需信用卡。进入“账户 → API 密钥 → 创建新密钥”。在 qveris.ai 注册免费账户即可获得 1,000 积分,无需信用卡。进入“账户 → API 密钥 → 创建新密钥”。

① 前往 qveris.ai/account?page=api-keys   ② 点击“创建 API 密钥”   ③ 复制您的密钥:qv-xxxxxxxxxxxxxxxxxxxx
02

打开模型工具设置打开模型工具设置打开模型工具设置

在编辑器中打开设置,进入模型工具配置区域。官方配置文档说明了支持的传输方式和配置文件位置。

模型工具配置
# 在编辑器中进入: 编辑器 → 设置 → 模型工具 → 添加服务器 # 或直接编辑: ~/.cursor/mcp.json
03

添加服务配置添加服务配置添加服务配置

把服务配置加入编辑器的模型工具设置文件。把服务配置加入编辑器的模型工具设置文件。把服务配置加入编辑器的模型工具设置文件。

~/.cursor/mcp.json
{ "mcpServers": { "qveris": { "command": "npx", "args": ["-y", "@qverisai/mcp"], "env": { "QVERIS_API_KEY": "your-api-key-here" } } } }
将配置中的密钥占位符替换为您在步骤 01 中复制的密钥。
04

重启并验证重启并验证重启并验证

重启编辑器以加载服务,然后在内置智能助手中验证连接。重启编辑器以加载服务,然后在内置智能助手中验证连接。重启编辑器以加载服务,然后在内置智能助手中验证连接。

智能助手验证
# 在内置智能助手中输入: “检查当前服务连接 并显示可用能力” # 预期响应: ✓ 服务已连接 ✓ 10,000+ 项能力可用 ✓ 剩余积分:1,000 ✓ 已可发现并调用工具

查看实际效果

下面是连接 QVeris 后可以直接交给 Cursor 的真实任务示例。下面是连接 QVeris 后可以直接交给 Cursor 的真实任务示例。下面是连接 QVeris 后可以直接交给 Cursor 的真实任务示例。

📈
“获取 AAPL、MSFT 和 GOOGL 的价格,并生成对比表”“获取 AAPL、MSFT 和 GOOGL 的价格,并生成对比表”“获取 AAPL、MSFT 和 GOOGL 的价格,并生成对比表”
✓ 实时市场数据✓ 实时市场数据✓ 实时市场数据
🌤
“获取东京当前天气,并整理为 JSON 对象”“获取东京当前天气,并整理为 JSON 对象”“获取东京当前天气,并整理为 JSON 对象”
✓ 实时天气✓ 实时天气✓ 实时天气
💱
“按当前汇率将 10,000 美元换算为日元、欧元和英镑”“按当前汇率将 10,000 美元换算为日元、欧元和英镑”“按当前汇率将 10,000 美元换算为日元、欧元和英镑”
✓ 实时汇率✓ 实时汇率✓ 实时汇率
₿
“获取 BTC、ETH 和 SOL 的价格,并计算我的投资组合价值”“获取 BTC、ETH 和 SOL 的价格,并计算我的投资组合价值”“获取 BTC、ETH 和 SOL 的价格,并计算我的投资组合价值”
✓ 实时加密货币数据✓ 实时加密货币数据✓ 实时加密货币数据
📰
“查找 OpenAI 的最新新闻并总结要点”“查找 OpenAI 的最新新闻并总结要点”“查找 OpenAI 的最新新闻并总结要点”
✓ 实时新闻✓ 实时新闻✓ 实时新闻
📄
“获取苹果最新财报数据,并添加到我的分析文件中”“获取苹果最新财报数据,并添加到我的分析文件中”“获取苹果最新财报数据,并添加到我的分析文件中”
✓ SEC 文件数据✓ SEC 文件数据✓ SEC 文件数据

CLI 还是 MCP Server 用于 Cursor?

MCP ServerCLI
最适合Cursor 内联 AI 聊天Cursor 终端与脚本
设置方式设置方式设置方式配置 mcp.json配置 mcp.json配置 mcp.json通过 npm 安装通过 npm 安装通过 npm 安装
工作方式工具 Schema 注入上下文子进程命令
输出方式在聊天中直接使用终端命令配合 --json
Token 成本Token 成本Token 成本Schema 注入Schema 注入Schema 注入约 50–100 Token约 50–100 Token约 50–100 Token
推荐场景推荐场景推荐场景✓ Cursor AI 聊天✓ Cursor AI 聊天✓ Cursor AI 聊天✓ Cursor 终端✓ Cursor 终端✓ Cursor 终端
建议两者搭配使用:MCP Server 负责内联 AI 聊天请求,CLI 负责 Cursor 集成终端中的脚本与自动化;二者可共用同一个 QVeris 账户和 API Key。建议两者搭配使用:MCP Server 负责内联 AI 聊天请求,CLI 负责 Cursor 集成终端中的脚本与自动化;二者可共用同一个 QVeris 账户和 API Key。建议两者搭配使用:MCP Server 负责内联 AI 聊天请求,CLI 负责 Cursor 集成终端中的脚本与自动化;二者可共用同一个 QVeris 账户和 API Key。

常见设置问题

MCP Server 未显示

① 使用 JSON 验证器检查 mcp.json 语法
② 确认已安装 npx:npx --version
③ 完全重启 Cursor,而不是只重新加载
④ 在 Cursor 设置 → MCP 中检查错误信息

API Key 无法识别

① 确认密钥以 qv- 开头
② 检查复制时是否带入多余空格
③ 在 qveris.ai/account 确认密钥处于启用状态
④ 如果问题仍然存在,请创建新密钥

工具调用返回错误

① 在 qveris.ai/account 检查积分余额
② 确认可以正常连接 qveris.ai
③ 在账户 → 使用记录中检查执行日志
④ 先在 qveris.ai/playground 在线演示中测试调用

常见问题

如何在 Cursor 中安装 QVeris?
编辑 ~/.cursor/mcp.json 添加 QVeris MCP Server 配置。设置您的 QVERIS_API_KEY 环境变量,重启 Cursor,集成即完成。完整设置不到 5 分钟 — 请参阅上文的分步指南。
QVeris 可以在 Cursor 中完成什么?
连接 QVeris 后,您的 Cursor AI 可以直接从 AI 聊天面板发现并调用 10,000+ 真实世界能力 — 包括实时股票价格、加密货币数据、天气、外汇汇率、新闻、SEC 文件、OCR、文档处理等。无需离开 IDE。无需编写 API 样板代码。
在 Cursor 中使用 QVeris MCP Server 免费吗?
MCP Server 本身是免费且开源的。发现和检查始终免费 — 零积分成本。积分仅在执行实时工具调用时消耗(每次调用 1–100 积分)。新账户注册即获 1,000 免费积分,无需信用卡。
在 Cursor 中使用 MCP Server 与 CLI 有什么区别?在 Cursor 中使用 MCP Server 与 CLI 有什么区别?在 Cursor 中使用 MCP Server 与 CLI 有什么区别?
MCP Server 直接集成到 Cursor 的 AI 聊天中 — 您的 AI 可以在回复时内联调用工具。CLI 在 Cursor 的集成终端中作为子进程运行。两者连接到同一个 QVeris 网络。大多数 Cursor 用户同时使用两者效果最佳 — MCP 用于聊天,CLI 用于脚本。
QVeris 支持 Cursor 的 Agent 模式吗?
是的。QVeris MCP Server 适用于所有 Cursor 模式,包括 Agent 模式。在 Agent 模式下,Cursor 可以自主发现并调用 QVeris 能力,作为多步骤编码工作流的一部分 — 获取实时数据、处理数据并直接写入您的代码库。
通过 MCP 将 QVeris 接入 Cursor | QVeris Guides