turbular
72
Turbular is an open-source MCP server aimed at facilitating seamless database connectivity for Language Models (LLMs). It is robust in supporting multiple database types and offers secure, optimized, and easily extensible features for sophisticated AI applications.
Turbular
Turbular is an open-source Model Context Protocol (MCP) server designed for seamless database connectivity with Language Models (LLMs). It offers a unified API to interact with multiple database types, optimizing AI applications that require multi-database workflows.
✨ Features
- Multi-Database Support: Connect to many database types through one API.
- Schema Normalization: Normalize schemas for LLM compatibility.
- Secure Connections: Support for SSL and various authentication methods.
- High Performance: Query optimization for LLM generated queries.
- Query Transformation: Transform normalized queries to their original form.
- Docker Support: Easy Docker and Docker Compose deployment.
- Easy to Extend: Extend with new database providers.
Supported Databases
- PostgreSQL, MySQL, SQLite, BigQuery, Oracle, MS SQL, Redshift.
Quick Start
Using Docker
- Clone the repository.
- Start the development environment.
- Test the connection.
Manual Installation
- Install Python 3.11 or higher.
- Install dependencies.
- Run the server.
API Reference
- Database Operations: Get Schema, Execute Query.
- File Management: Upload BigQuery Key, Upload SQLite Database.
- Utility Endpoints: Health Check, List Supported Databases.
Development Setup
- Fork and clone the repository.
- Create a development environment using Docker.
- Access the API documentation.
Contributing
- Follow our guidelines to contribute through issues, documentation, and code enhancements.
Roadmap
- More testing and formatting tools.
- SSH and other data sources support.
Testing
Run tests with pytest or through included scripts for PostgreSQL.
Documentation
Refer to our API and contributing guides.
License
MIT License.
Acknowledgments
- FastAPI, SQLAlchemy, contributors.