Skip to main content
Glama
santosh07401

Redshift MCP Server

by santosh07401
README.md
# Redshift MCP Server

A Model Context Protocol (MCP) server that enables AI agents to interact with Amazon Redshift using natural language.

## Features

- **SQL Tools**: Execute queries, list tables, describe schemas, get sample data.
- **Resources**: Connection status, table list.
- **Sample Data**: Pre-configured users, products, and orders tables.
- **Architecture**: See [DESIGN.md](DESIGN.md) for system diagrams.

---

## 🚀 Quick Start

For detailed instructions on **Windows, macOS, and Linux**, please refer to the [SETUP.md](SETUP.md) guide.

### Basic Steps (Local Testing):

1. **Start Postgres**: `docker run -d -p 5432:5432 --name postgres -e POSTGRES_PASSWORD=password postgres`
2. **Install Deps**: `pip install mcp redshift-connector pandas python-dotenv psycopg2-binary sqlalchemy`
3. **Seed Data**: `python seed_redshift.py`
4. **Test**: `python test_redshift_local.py`

---

## 🔧 MCP Client Configuration

Add this to your MCP client configuration (e.g., Antigravity, Claude Code, or VS Code).

```json
"redshift-mcp": {
  "command": "py",
  "args": ["redshift_mcp_server.py"],
  "cwd": "c:/Users/santo/OneDrive/Desktop/workspace/redis connection",
  "env": {
    "REDSHIFT_HOST": "localhost",
    "REDSHIFT_PORT": "5432",
    "REDSHIFT_DATABASE": "postgres",
    "REDSHIFT_USER": "postgres",
    "REDSHIFT_PASSWORD": "password"
  }
}
```

---

## ☁️ AWS Deployment

See [AWS_DEPLOYMENT.md](AWS_DEPLOYMENT.md) for deployment options.

TDQS

A3.5/5.0

Scored across 5 tools

Disambiguation5/5

Each tool has a clearly distinct purpose with no overlap: connection status check, table description, data sampling, table listing, and query execution. The descriptions make it unambiguous which tool to use for each database interaction task.

Naming Consistency5/5

All tools follow a perfect 'redshift_verb_noun' pattern with consistent snake_case throughout. The naming convention is predictable and immediately communicates both the domain (Redshift) and the specific action.

Tool Count5/5

Five tools is well-scoped for a database server, covering essential operations without bloat. Each tool earns its place by addressing a core database interaction need, from metadata exploration to data querying.

Completeness4/5

The toolset covers the most critical database operations well: schema exploration (list_tables, describe_table), data access (get_sample_data, query), and system status. The main gap is the lack of write/update operations (CREATE, INSERT, UPDATE, DELETE), though this might be intentional for a read-focused server.

Maintenance

ActivityInactive
ResponsivenessNo issues