Ollama PostgreSQL Data Analysis

🚀 Ollama MCP 數據庫助手

Ollama MCP 數據庫助手結合了 Ollama 的大語言模型 (LLM) 功能與 PostgreSQL 數據庫，通過 Model Context Protocol (MCP) 協議實現了交互式聊天界面。用戶可以用自然語言提問關於數據的問題，獲得由真實 SQL 查詢支持的 AI 驅動響應。

🚀 快速開始

本工具可讓你以自然語言與 PostgreSQL 數據庫交互，獲取數據洞察。按以下步驟操作，即可快速開啟數據探索之旅。

✨ 主要特性

• 🌐 自然語言接口：支持使用自然語言訪問 PostgreSQL 數據庫。
• 🤖 自動生成 SQL：自動生成 SQL 查詢，無需手動編寫。
• 📊 基於模式響應：根據數據庫模式生成準確響應。
• 💬 交互式界面：提供交互式聊天界面，操作便捷。
• 🔒 安全訪問：僅提供只讀數據庫訪問，保障數據安全。

📦 安裝指南

先決條件

• Node.js 16 或更高版本
• 正在運行的 PostgreSQL 數據庫
• Ollama 已安裝並正在本地運行
• Ollama 中拉取了 qwen2.5-coder:7b-instruct 模型

安裝步驟

1. 克隆倉庫：

git clone [your-repo-url]
cd [your-repo-name]

2. 安裝依賴項：

npm install

3. 拉取所需的 Ollama 模型：

ollama pull qwen2.5-coder:7b-instruct

4. 在項目根目錄中創建一個 .env 文件：

DATABASE_URL=postgresql://user:password@localhost:5432/dbname
OLLAMA_MODEL=qwen2.5-coder:7b-instruct  # 可選，默認值為 qwen2.5-coder:7b-instruct

💻 使用示例

基礎用法

1. 啟動聊天界面：

npm start

2. 提問關於您數據的問題，以自然語言形式輸入：

已連接到數據庫。您可以現在提問關於您的數據。
輸入 "exit" 退出。

您想了解的數據是什麼？上個月哪些產品產生了最多的收入？
正在分析...

[AI 將生成並執行一個 SQL 查詢，然後解釋結果]

3. 輸入 'exit' 退出應用程序。

📚 詳細文檔

工作原理

1. 應用程序通過 PostgreSQL MCP 服務器 連接到您的 PostgreSQL 數據庫。
2. 加載並緩存您的數據庫模式。
3. 當您提問時：
   • 模式和問題發送到 Ollama。
   • Ollama 生成適當的 SQL 查詢。
   • 查詢通過 MCP 執行。
   • 結果返回到 Ollama 進行解釋。
   • 您收到自然語言的響應。

環境變量

安全

• 僅限只讀訪問。
• SQL 查詢限制。

開發信息

使用的技術：TypeScript、MCP、Node.js 等。

故障排除

常見問題

1. 無法連接到數據庫
   • 檢查 DATABASE_URL 是否正確。
   • 確保 PostgreSQL 服務正在運行。
2. Ollama 未響應
   • 確保 Ollama 已安裝並運行。
   • 檢查網絡連接。
3. 環境變量配置錯誤
   • 核對 .env 文件中的值是否正確。

📄 許可證

[此處填寫許可證信息]

🤝 貢獻指南

歡迎貢獻！請參考 貢獻指南