MCP Configuration

MCP (Model Context Protocol) is a protocol that enables AI IDEs to access external data and servers. Lovrabet CLI provides one-click MCP configuration, allowing you to directly access Lovrabet datasets in IDEs like Cursor, Claude Code, and more.

What is Lovrabet MCP?

The Lovrabet MCP server (@lovrabet/dataset-mcp-server) is an MCP service that enables AI IDEs to:

• 📋 List datasets - View all available Lovrabet datasets
• 🔍 Get dataset details - View dataset field definitions, types, enum values, etc.
• 📝 Generate SDK code - Automatically generate SDK call code for datasets
• 🔎 Search datasets - Search datasets by name
• 📊 Compare datasets - Compare differences between two datasets

Use Cases

In an AI IDE, you can directly converse with AI:

You: Help me query the user dataset to get all active users

AI: [Uses MCP tools to get dataset information]
I'll help you write the query code...

You: Generate TypeScript type definitions for the order dataset

AI: [Uses MCP to get dataset fields]
Here are the generated type definitions...

---

Quick Start

Prerequisites

1. Lovrabet CLI installed
2. Project configured with appcode (ran lovrabet init or lovrabet create)
3. Logged into Lovrabet (ran lovrabet auth)

Configure Cursor MCP

lovrabet mcp install --cursor

What happens?

1. CLI reads .lovrabetrc configuration to get appcode
2. Creates .cursor/mcp.json file
3. Writes MCP server configuration
4. Copies .cursor/rules/lovrabet_rules.mdc rules file

Configuration example:

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

After completion:

• Restart Cursor
• Confirm lovrabet-dataset MCP server is loaded in Cursor

Configure Claude Code MCP

lovrabet mcp install --claude

What happens?

1. CLI reads .lovrabetrc configuration to get appcode
2. Generates configuration command for you to execute manually
3. Creates agents.md rules file

Execute the output command:

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

After completion:

• Restart Claude Code
• Confirm MCP server is loaded in Claude Code

---

Other IDE Configuration

lovrabet mcp install --other

This displays the generic MCP configuration JSON, which you can copy to your IDE's configuration file.

Configuration template:

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

---

MCP Tools Reference

After configuration, the AI IDE can use the following MCP tools:

Tool Name	Description
login_browser	Browser login authentication
list_datasets	List all datasets
get_dataset_detail	Get dataset details (including field metadata)
get_operation_detail	Get operation details
search_datasets	Search datasets
generate_sdk	Generate SDK code
compare_datasets	Compare two datasets

---

Environment Variables

The MCP server supports the following environment variables:

Variable Name	Description	Required
LOVRABET_APP_CODE	Application code	Yes
LOVRABET_ENV	Runtime environment (online/daily)	No, defaults to online

---

Verify Configuration

Verify in Cursor

1. Restart Cursor
2. Open Command Palette (Cmd+Shift+P)
3. Type "MCP" to view MCP-related options
4. Confirm lovrabet-dataset is in the list

Verify in Claude Code

1. Restart Claude Code
2. In the chat, type: Can you access lovrabet datasets?
3. AI should be able to call MCP tools

---

Troubleshooting

Problem: MCP Server Not Loading

Check:

1. Confirm .lovrabetrc file exists and contains appcode
2. Confirm you have run lovrabet auth to log in
3. Restart IDE

Solution:

# Check configuration
cat .lovrabetrc

# Reconfigure
lovrabet mcp install --cursor

Problem: Cookie Expired

Symptom: MCP tools return authentication errors

Solution:

# Re-login
lovrabet auth

# Restart IDE

Problem: Dataset Not Found

Check:

1. Confirm appcode is correct
2. Confirm you have access to the dataset
3. Check environment variable configuration

---

Using with Skills

MCP configuration works best with Lovrabet skills:

# Install skill
lovrabet skill install cursor

# Configure MCP
lovrabet mcp install --cursor

Skills provide:

• Filter query building standards (avoid common errors)
• MCP SQL creation workflow
• AntD UI development standards
• API integration guide

---

Related Documentation

• skill Installation - Install development standards and guides
• Command Reference - All CLI commands
• MCP Official Documentation - Learn about the MCP protocol