sqlite-database-mcp-server

canergulsoyy/sqlite-database-mcp-server

3.1

If you are the rightful owner of sqlite-database-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Database MCP Server is a modern Node.js application that offers database querying capabilities using the Model Context Protocol (MCP) with LLM integration for natural language queries.

Tools
6
Resources
0
Prompts
0

🗄️ Database MCP Server

🎯 Proje Hakkında

Database MCP Server, Model Context Protocol (MCP) kullanarak veritabanı sorgulama yetenekleri sunan modern bir Node.js uygulamasıdır. LLM entegrasyonu ile doğal dil kullanarak veritabanı sorguları yapabilirsiniz.

✨ Özellikler

  • 🚀 MCP 1.3.0 protokol desteği
  • 🗄️ SQLite veritabanı entegrasyonu
  • 🤖 LLM entegrasyonu (OpenAI/OpenRouter)
  • 🔍 Gelişmiş sorgu filtreleme ve arama
  • 📊 Gerçek zamanlı istatistikler ve raporlama
  • 🛡️ Güvenli SQL sorguları (sadece SELECT)
  • 📱 Interactive CLI arayüzü
  • 🧪 Otomatik test senaryoları
  • 🔧 TypeScript ile tam tip güvenliği

🚀 Hızlı Başlangıç

Gereksinimler

  • Node.js >= 18.18.0
  • npm veya yarn
  • OpenRouter API Key (ücretsiz)

Kurulum

# Repository'yi klonlayın
git clone https://github.com/canergulsoyy/database-mcp-server.git
cd database-mcp-server

# Bağımlılıkları yükleyin
npm install

# Environment dosyasını oluşturun
cp env.example .env

# OpenRouter API key'inizi ekleyin
# .env dosyasını düzenleyin

# Projeyi build edin
npm run build

# Veritabanını kurun
npm run db:setup
npm run db:seed

# Server'ı başlatın
npm start

Kullanım

# Interactive CLI
npm run client:dev

# Test client
npm run test:client

# Development mode
npm run dev

🏗️ Mimari

src/
├── index.ts              # MCP Server ana dosyası
├── database/
│   ├── setup.ts         # Veritabanı yönetimi
│   ├── query-service.ts # Sorgu servisleri
│   └── seed.ts          # Örnek veri ekleme
└── client/
    ├── index.ts         # CLI arayüzü
    └── weather-client.ts # LLM client

🗄️ MCP Tools

  • health_check - Veritabanı sağlık kontrolü
  • get_users - Kullanıcı yönetimi
  • get_products - Ürün yönetimi
  • get_orders - Sipariş yönetimi
  • get_database_stats - Veritabanı istatistikleri
  • execute_custom_query - Özel SQL sorguları

📚 Dokümantasyon

  • - Ana dokümantasyon
  • - Katkıda bulunma rehberi
  • - Sürüm değişiklikleri
  • - Güvenlik politikası
  • - Destek ve yardım

🤝 Katkıda Bulunma

Bu projeye katkıda bulunmak istiyorsanız:

  1. Fork yapın
  2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
  3. Commit yapın (git commit -m 'Add amazing feature')
  4. Push yapın (git push origin feature/amazing-feature)
  5. Pull Request oluşturun

Detaylı bilgi için dosyasını inceleyin.

🚀 Deployment

Docker ile

# Production
docker-compose up

# Development
docker-compose --profile dev up

# Test
docker-compose --profile test up

Manuel Kurulum

npm run build
npm start

🔐 Güvenlik

Güvenlik açıklarını özel olarak rapor edin:

📄 License

Bu proje altında lisanslanmıştır.

🙏 Teşekkürler

📞 İletişim

⭐ Bu projeyi beğendiyseniz yıldız vermeyi unutmayın!