MCP Server for Amazon Redshift

Redshift MCP 服务

Amazon Redshift 的模型上下文协议（MCP）服务实现，通过 AI 模型提供与 Redshift 数据库交互的标准化接口。

功能

• 列出多个架构中的表、视图和物化视图
• 在单个请求中获取多个表的详细架构信息
• 对 Redshift 执行只读 SQL 查询
• 支持 stdio 和 SSE（服务器发送事件）传输方式
• 使用 TypeScript 实现类型安全

前提条件

• Node.js 18 或更高版本
• 可访问 Redshift 数据库
• 已配置环境变量（参见“配置”部分）

安装

1. 克隆仓库：

   git clone https://github.com/yourusername/mcp-server-redshift.git
   cd mcp-server-redshift
   

2. 安装依赖：

   npm install
   

3. 构建项目：

   npm run build
   

配置

在根目录中创建 .env 文件，并添加以下变量：

# Redshift Connection
REDSHIFT_HOST=your-redshift-host
REDSHIFT_PORT=5439
REDSHIFT_DATABASE=your-database
REDSHIFT_USER=your-username
REDSHIFT_PASSWORD=your-password
REDSHIFT_SCHEMAS=public,schema1,schema2  # Comma-separated list of schemas

# Server Configuration
TRANSPORT_TYPE=stdio  # or 'sse' for Server-Sent Events
PORT=3000  # Only used when TRANSPORT_TYPE=sse

使用方法

运行服务

# Development
npm run dev

# Production
npm run build
npm start

可用工具

1. 列出表（list_tables）

   • 列出指定架构中的所有表、视图和物化视图
   • 可选的 schemas 参数，用于筛选指定架构

   {
     "schemas": ["public", "analytics"]
   }
   

2. 获取表架构（get_tables_schema）

   • 获取多个架构中多个表的架构信息

   {
     "tables": [
       { "schema": "public", "table": "users" },
       { "schema": "analytics", "table": "events" }
     ]
   }
   

3. 查询（query）

   • 对数据库执行只读 SQL 查询

   {
     "sql": "SELECT * FROM public.users LIMIT 5"
   }
   

测试

运行测试套件：

npm test

架构

项目按以下结构组织：

src/
├── config/         # Configuration and database setup
├── tools/          # Individual tool implementations
├── server/         # Server setup and transport configuration
└── index.ts        # Main entry point

安全注意事项

• 所有查询都在只读事务中执行
• 应妥善保护环境变量
• SSE 传输已启用 CORS（生产环境中应进行配置）
• 应安全管理数据库凭据

贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 将更改推送到分支（git push origin feature/amazing-feature）
5. 发起 Pull Request

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

致谢

本项目基于 Model Context Protocol 项目的 PostgreSQL MCP 服务。特别感谢原作者所做的工作。