Ollama PostgreSQL Data Analysis

🚀 Ollama MCP データベースアシスタント

このアプリケーションは、Ollama の大規模言語モデル (LLM) 機能と PostgreSQL データベースを、Model Context Protocol (MCP) を通じて統合した対話型チャットインターフェースです。自然言語でデータに関する質問を行い、実際の SQL クエリに基づく AI 駆動の応答を得ることができます。

✨ 主な機能

• PostgreSQL データベースへの自然言語インターフェース
• 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 ファイルの値が正しいことを確認してください。

📄 ライセンス

[ここにライセンス情報を記載]

コントリビューションガイド

コントリビューションを歓迎します！詳細は コントリビューションガイド を参照してください。