SingleStore

v1.0.0Databasesstable

An implementation of the Model Context Protocol (MCP) server for SingleStore that enables natural language interaction with SingleStore databases through compatible LLM clients like Claude Desktop and Cursor.

singlestore-mcp-servermcpai-integration
Share:
33
Stars
0
Downloads
0
Weekly
0/5

What is SingleStore?

SingleStore is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to implementation of the model context protocol (mcp) server for singlestore that enables natural language interaction with singlestore databases through compatible llm clients like claude desktop and cu...

An implementation of the Model Context Protocol (MCP) server for SingleStore that enables natural language interaction with SingleStore databases through compatible LLM clients like Claude Desktop and Cursor.

This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An implementation of the Model Context Protocol (MCP) server

Use Cases

Query SingleStore databases using natural language conversations with Claude.
Execute SQL++ queries on Capella clusters through conversational AI interfaces.
LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedMay 3, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx singlestore-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use SingleStore

The SingleStore MCP server provides a natural-language interface to SingleStore databases, allowing AI assistants like Claude to query workspaces, run SQL++ statements, manage notebooks, schedule jobs, and handle stage file storage through a conversational interface. It connects to the SingleStore portal via OAuth browser authentication, so no manual credential configuration is needed for standard installs. Teams use it to explore and operate cloud databases without switching between SQL tools and their AI assistant.

Prerequisites

  • A SingleStore account with at least one workspace group and workspace
  • Python 3.10+ and uvx (part of uv) installed, or Docker for containerized deployment
  • An MCP client such as Claude Desktop, Cursor, or VS Code with MCP extension
  • Docker and a SingleStore API key if running the containerized version
1

Add the server to your MCP client config

Edit your MCP client configuration file to declare the SingleStore server. For most clients uvx is the simplest launch method and no credentials are required — the server opens a browser for OAuth on first run.

{
  "mcpServers": {
    "singlestore-mcp-server": {
      "command": "uvx",
      "args": ["singlestore-mcp-server", "start"]
    }
  }
}
2

Authenticate via browser OAuth

On first startup the server will open a browser window prompting you to log in to your SingleStore account and grant access. Complete this flow and return to your MCP client.

3

Select your workspace

Once authenticated, tell your AI assistant which workspace or workspace group to connect to. The server will list available options and let you select the target database.

4

Run a SQL query

Use the run_sql tool (invoked automatically by your AI assistant) to execute queries against your SingleStore workspace.

5

(Optional) Docker deployment with API key

For headless or CI environments where browser OAuth is unavailable, run the server in Docker and provide an API key via the MCP_API_KEY environment variable.

docker run -e MCP_API_KEY=your_api_key_here singlestore-mcp-server

SingleStore Examples

Client configuration

Standard uvx configuration for Claude Desktop. No API key is needed; OAuth handles authentication on first launch.

{
  "mcpServers": {
    "singlestore-mcp-server": {
      "command": "uvx",
      "args": ["singlestore-mcp-server", "start"]
    }
  }
}

Prompts to try

After connecting, use these prompts to explore and operate your SingleStore databases through your AI assistant.

- "List all workspace groups in my SingleStore organization"
- "Run this query on my workspace: SELECT COUNT(*) FROM orders WHERE created_at > NOW() - INTERVAL 7 DAY"
- "Create a notebook for exploratory analysis of the customers table"
- "Schedule a job from my analytics notebook to run every Sunday at midnight"
- "Upload the file report.csv to stage storage in my current workspace"

Troubleshooting SingleStore

Browser OAuth window does not open

Ensure you are running in an environment with a desktop browser available. For headless servers, switch to Docker with MCP_API_KEY instead of the uvx approach.

uvx command not found

Install uv first: 'pip install uv' or 'brew install uv'. uvx is bundled with uv and allows running Python packages in isolated environments without a separate install step.

SQL query fails with workspace not connected error

Suspended starter workspaces need to be resumed first. Ask your assistant to 'resume my workspace' and wait for it to come online before executing queries.

Frequently Asked Questions about SingleStore

What is SingleStore?

SingleStore is a Model Context Protocol (MCP) server that implementation of the model context protocol (mcp) server for singlestore that enables natural language interaction with singlestore databases through compatible llm clients like claude desktop and cursor. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install SingleStore?

Follow the installation instructions on the SingleStore GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with SingleStore?

SingleStore works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is SingleStore free to use?

Yes, SingleStore is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Databases MCP Servers

Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "singlestore-mcp-server": { "command": "npx", "args": ["-y", "singlestore-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use SingleStore?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides