local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Manages environment variables for database connection strings and model configuration in a secure way.
Provides the runtime environment needed for executing the MCP server application.
Leverages Ollama's LLM capabilities to interpret natural language questions, generate SQL queries, and provide AI-powered responses based on database results.

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

OllamaのLLM機能と、モデルコンテキストプロトコル（MCP）を介したPostgreSQLデータベースアクセスを組み合わせたインタラクティブなチャットインターフェースです。データに関する質問を自然言語で投げかけると、AIが実際のSQLクエリに基づいた回答を返してくれます。

特徴

PostgreSQL データベースへの自然言語インターフェース
自動SQLクエリ生成
スキーマ認識応答
インタラクティブなチャットインターフェース
安全な読み取り専用データベースアクセス

前提条件

Node.js 16以上
実行中のPostgreSQLデータベース
Ollamaをローカルにインストールして実行
qwen2.5-coder:7b-instructモデルはOllamaに取り込まれました

設定

リポジトリをクローンします。

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

依存関係をインストールします:

npm install

必要な Ollama モデルを取得します。

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

プロジェクトルートに.envファイルを作成します。

DATABASE_URL=postgresql://user:password@localhost:5432/dbname
OLLAMA_MODEL=qwen2.5-coder:7b-instruct  # Optional - this is the default

使用法

チャットインターフェイスを開始します。

npm start

自然言語でデータについて質問します。

Connected to database. You can now ask questions about your data.
Type "exit" to quit.

What would you like to know about your data? Which products generated the most revenue last month?
Analyzing...

[AI will generate and execute a SQL query, then explain the results]

アプリケーションを終了するには、「exit」と入力します。

仕組み

アプリケーションはPostgreSQL MCPサーバーを介してPostgreSQLデータベースに接続します。
データベーススキーマをロードしてキャッシュします
質問するときは：
- スキーマと質問はOllamaに送信されます
- Ollamaは適切なSQLクエリを生成する
- クエリはMCPを通じて実行される
- 結果は解釈のためにオラマに送り返される
- 自然言語による応答を受け取ります

環境変数

変数	説明	デフォルト
データベースURL	PostgreSQL接続文字列	必須
OLLAMA_モデル	使用するオラマモデル	qwen2.5-コーダー:7b-命令

安全

すべてのデータベースアクセスは読み取り専用です
SQLクエリはSELECT文に制限されます
データベースの資格情報は .env ファイルで安全に保管されます

発達

搭載コンポーネント:

タイプスクリプト
モデルコンテキストプロトコル（MCP）
オラマ
PostgreSQL

トラブルシューティング

よくある問題

「データベースへの接続に失敗しました」
- .env の DATABASE_URL を確認してください
- PostgreSQLが実行中であることを確認する
- ネットワーク接続を確認する
「Ollamaへの接続に失敗しました」
- Ollama が実行中であることを確認する ( ollama serve )
- モデルがインストールされていることを確認します（ ollama list ）
「クエリ実行エラー」
- データベースの権限を確認する
- スキーマ内のテーブル/列名を確認する

ライセンス

マサチューセッツ工科大学

貢献

リポジトリをフォークする
機能ブランチを作成する
変更をコミットする
ブランチにプッシュする
プルリクエストを開く

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested