跳到主要内容

MCP 配置

MCP (Model Context Protocol) 是一种让 AI IDE 能够访问外部数据和服务器的协议。Lovrabet CLI 提供了一键配置 MCP 的功能，让你可以在 Cursor、Claude Code 等 IDE 中直接访问 Lovrabet 数据集。

什么是 Lovrabet MCP？​

Lovrabet MCP 服务器 (@lovrabet/dataset-mcp-server) 是一个 MCP 服务，让 AI IDE 能够：

  • 📋 列出数据集 - 查看所有可用的 Lovrabet 数据集
  • 🔍 获取数据集详情 - 查看数据集的字段定义、类型、枚举值等
  • 📝 生成 SDK 代码 - 自动生成数据集的 SDK 调用代码
  • 🔎 搜索数据集 - 按名称搜索数据集
  • 📊 对比数据集 - 对比两个数据集的差异

使用场景​

在 AI IDE 中，你可以直接与 AI 对话：

你：帮我查询用户数据集，获取所有活跃用户

AI：[使用 MCP 工具获取数据集信息]
我来帮你编写查询代码...

你：生成订单数据集的 TypeScript 类型定义

AI：[使用 MCP 获取数据集字段]
这是生成的类型定义...

快速开始​

前置条件​

  1. 已安装 Lovrabet CLI
  2. 项目已配置 appcode（运行过 lovrabet init 或 lovrabet create）
  3. 已登录 Lovrabet（运行过 lovrabet auth）

配置 Cursor MCP​

lovrabet mcp install --cursor

会发生什么？

  1. CLI 读取 .lovrabetrc 配置获取 appcode
  2. 创建 .cursor/mcp.json 文件
  3. 写入 MCP 服务器配置
  4. 复制 .cursor/rules/lovrabet_rules.mdc 规则文件

配置示例：

{
  "mcpServers": {
    "lovrabet-dataset": {
      "command": "npx",
      "args": ["-y", "@lovrabet/dataset-mcp-server"],
      "env": {
        "LOVRABET_APP_CODE": "your-app-code",
        "LOVRABET_ENV": "online"
      }
    }
  }
}

完成后：

  • 重启 Cursor
  • 在 Cursor 中确认 lovrabet-dataset MCP 服务器已加载

配置 Claude Code MCP​

lovrabet mcp install --claude

会发生什么？

  1. CLI 读取 .lovrabetrc 配置获取 appcode
  2. 生成配置命令供你手动执行
  3. 创建 agents.md 规则文件

执行输出的命令：

claude mcp add lovrabet-dataset --scope user npx -y @lovrabet/dataset-mcp-server -e LOVRABET_APP_CODE=your-app-code

完成后：

  • 重启 Claude Code
  • 在 Claude Code 中确认 MCP 服务器已加载

其他 IDE 配置​

lovrabet mcp install --other

这会显示通用的 MCP 配置 JSON，你可以将其复制到对应 IDE 的配置文件中。

配置模板：

{
  "mcpServers": {
    "lovrabet-dataset": {
      "command": "npx",
      "args": ["-y", "@lovrabet/dataset-mcp-server"],
      "env": {
        "LOVRABET_APP_CODE": "your-app-code",
        "LOVRABET_ENV": "online"
      }
    }
  }
}

MCP 工具说明​

配置完成后，AI IDE 可以使用以下 MCP 工具：

工具名称说明
login_browser浏览器登录认证
list_datasets列出所有数据集
get_dataset_detail获取数据集详情（含字段元数据）
get_operation_detail获取操作详情
search_datasets搜索数据集
generate_sdk生成 SDK 代码
compare_datasets对比两个数据集

环境变量​

MCP 服务器支持以下环境变量：

变量名说明必需
LOVRABET_APP_CODE应用代码是
LOVRABET_ENV运行环境（online/daily）否，默认 online

验证配置​

在 Cursor 中验证​

  1. 重启 Cursor
  2. 打开 Command Palette (Cmd+Shift+P)
  3. 输入 "MCP" 查看 MCP 相关选项
  4. 确认 lovrabet-dataset 在列表中

在 Claude Code 中验证​

  1. 重启 Claude Code
  2. 在聊天中输入：你能访问 lovrabet 数据集吗？
  3. AI 应该能调用 MCP 工具

故障排查​

问题：MCP 服务器未加载​

检查项：

  1. 确认 .lovrabetrc 文件存在且包含 appcode
  2. 确认已运行 lovrabet auth 登录
  3. 重启 IDE

解决方法：

# 检查配置
cat .lovrabetrc

# 重新配置
lovrabet mcp install --cursor

问题：Cookie 过期​

症状： MCP 工具返回认证错误

解决方法：

# 重新登录
lovrabet auth

# 重启 IDE

问题：找不到数据集​

检查项：

  1. 确认 appcode 正确
  2. 确认你有该数据集的访问权限
  3. 检查环境变量配置

与skill配合使用​

MCP 配置与 Lovrabet skill配合使用效果更佳：

# 安装skill
lovrabet skill install cursor

# 配置 MCP
lovrabet mcp install --cursor

skill提供了：

  • Filter 查询构建规范（避免常见错误）
  • MCP SQL 创建工作流
  • AntD UI 开发规范
  • API 集成指南

相关文档​