Skip to main content
Glama
DeepaRajareddy

Redshift MCP Server

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/deepa/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

B3.4/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 reinforce these distinct roles, making tool selection straightforward for an agent.

Naming Consistency5/5

All tools follow a consistent 'redshift_' prefix with descriptive snake_case names (e.g., redshift_describe_table, redshift_query). This predictable pattern enhances readability and reduces cognitive load for users or agents.

Tool Count4/5

With 5 tools, the server is well-scoped for basic Redshift database interactions, covering essential operations like connection, metadata, and querying. It could be slightly expanded to include more advanced features (e.g., data modification), but the current count is reasonable for its purpose.

Completeness3/5

The toolset covers core read-only operations (status, metadata, querying) but lacks data manipulation tools (e.g., insert, update, delete) and schema management (e.g., create table). This creates gaps for agents needing full CRUD capabilities, though basic exploration and querying are well-supported.

Maintenance

ActivityInactive
ResponsivenessNo issues