跳到主要内容

客户端配置

本文档介绍如何在各种 AI 编辑器和开发环境中配置 Lovrabet MCP 服务器。

标准配置​

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

配置参数说明​

参数必填说明
LOVRABET_APP_CODE是你的 Lovrabet 应用 AppCode
LOVRABET_ENV否环境：online（默认）或 daily
MCP_DEBUG否设置为 1 启用详细日志

MCP 客户端配置​

Amp​

访问 https://ampcode.com/manual#mcp 按照上述标准配置。也可以使用 CLI 安装：

amp mcp add lovrabet-dataset -- npx -y @lovrabet/dataset-mcp-server

Antigravity​

访问 https://antigravity.google/docs/mcp 安装自定义 MCP 服务器。添加以下配置：

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

Claude Code​

使用 Claude Code CLI 添加 Lovrabet MCP 服务器：

claude mcp add lovrabet-dataset --scope user npx -y @lovrabet/dataset-mcp-server

或手动编辑 ~/.claude/settings.json：

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

Claude Desktop​

编辑配置文件：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "lovrabet-dataset": {
      "command": "npx",
      "args": ["-y", "@lovrabet/dataset-mcp-server"],
      "env": {
        "LOVRABET_APP_CODE": "your-app-code"
      }
    }
  }
}

Cline​

访问 https://docs.cline.bot/mcp/configuring-mcp-servers 并使用上述标准配置。

Codex​

按照 MCP 配置指南 使用标准配置。也可以使用 Codex CLI 安装：

codex mcp add lovrabet-dataset -- npx -y @lovrabet/dataset-mcp-server

Windows 11

在 .codex/config.toml 中配置：

[mcp_servers.lovrabet-dataset]
command = "cmd"
args = [
    "/c",
    "npx",
    "-y",
    "@lovrabet/dataset-mcp-server",
]
env = { LOVRABET_APP_CODE = "your-app-code" }
startup_timeout_ms = 20_000

Copilot CLI​

启动 Copilot CLI 并运行：

/mcp add

配置以下字段并按 CTRL+S 保存：

  • Server name: lovrabet-dataset
  • Server Type: [1] Local
  • Command: npx -y @lovrabet/dataset-mcp-server
  • Environment Variables: LOVRABET_APP_CODE=your-app-code

Copilot / VS Code​

使用 VS Code CLI：

code --add-mcp '{"name":"io.lovrabet.dataset-mcp-server","command":"npx","args":["-y","@lovrabet/dataset-mcp-server"],"env":{"LOVRABET_APP_CODE":"your-app-code"}}'

或手动按照 MCP 安装指南 操作。

Cursor​

前往 Cursor Settings -> MCP -> New MCP Server。使用上述标准配置。

Factory CLI​

使用 Factory CLI：

droid mcp add lovrabet-dataset "npx -y @lovrabet-dataset-mcp-server"

Gemini CLI​

项目范围：

gemini mcp add lovrabet-dataset npx -y @lovrabet-dataset-mcp-server

全局：

gemini mcp add -s user lovrabet-dataset npx -y @lovrabet-dataset-mcp-server

Gemini Code Assist​

按照 MCP 配置指南 使用标准配置。

JetBrains AI Assistant & Junie​

前往 Settings | Tools | AI Assistant | Model Context Protocol (MCP) -> Add。使用标准配置。 JetBrains Junie 同样在 Settings | Tools | Junie | MCP Settings -> Add 中配置。

Kiro​

在 Kiro Settings 中，前往 Configure MCP > Open Workspace or User MCP Config > 使用标准配置。

或从 IDE 活动栏 > Kiro > MCP Servers > Click Open MCP Config。使用标准配置。

OpenCode​

添加到 ~/.config/opencode/opencode.json（指南）：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "lovrabet-dataset": {
      "type": "local",
      "command": ["npx", "-y", "@lovrabet-dataset-mcp-server"],
      "env": {
        "LOVRABET_APP_CODE": "your-app-code"
      }
    }
  }
}

Qoder​

在 Qoder Settings 中，前往 MCP Server > + Add > 使用标准配置。

或使用 Qoder CLI（指南）：

项目范围：

qodercli mcp add lovrabet-dataset -- npx -y @lovrabet-dataset-mcp-server

全局：

qodercli mcp add -s user lovrabet-dataset -- npx -y @lovrabet-dataset-mcp-server

Trae​

前往 Settings -> MCP Servers -> + Add。使用上述标准配置。

Windsurf​

按照 MCP 配置指南 使用标准配置。

全局安装​

如果不想每次使用 npx 下载，可以全局安装：

npm install -g @lovrabet/dataset-mcp-server

然后配置使用本地命令：

{
  "mcpServers": {
    "lovrabet-dataset": {
      "command": "lovrabet-dataset-mcp",
      "env": {
        "LOVRABET_APP_CODE": "your-app-code"
      }
    }
  }
}

验证配置​

配置完成后，在 AI 编辑器中输入：

列出所有数据集

如果能返回数据集列表，说明配置成功。

故障排除​

MCP 服务器无法启动​

  1. 确认 Node.js 版本：需要 Node.js >= 18

    node --version

  2. 测试 MCP 服务器：

    npx -y @lovrabet/dataset-mcp-server

  3. 检查日志：设置 MCP_DEBUG=1 环境变量查看详细日志

如果出现认证错误，在 AI 编辑器中输入：

请帮我登录 Lovrabet

配置文件位置​

编辑器配置文件路径
Claude Desktop (Mac)~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Win)%APPDATA%\Claude\claude_desktop_config.json
Claude Code~/.claude/settings.json
Cursor.cursor/mcp.json
Codex~/.codex/config.toml
OpenCode~/.config/opencode/opencode.json
Windsurf.windsurf/mcp_config.json

参考资源​