Ollama MCP Database Assistant

基本能力

产品定位

Ollama MCP Database Assistant 是一个数据库交互工具，通过自然语言接口提供对 PostgreSQL 数据库的智能访问和分析能力。

核心功能

• 自然语言接口访问 PostgreSQL 数据库
• 自动生成 SQL 查询
• 基于数据库模式的响应
• 交互式聊天界面
• 安全的只读数据库访问

适用场景

• 数据分析师需要快速查询数据库
• 开发人员需要理解数据库结构和内容
• 非技术人员需要以自然语言方式访问数据库信息

工具列表

• PostgreSQL MCP server: 提供数据库连接和查询能力
• Ollama: 提供自然语言处理和 SQL 生成能力

常见问题解答

1. 数据库连接失败
2. 检查 .env 文件中的 DATABASE_URL
3. 确认 PostgreSQL 是否正在运行
4. 检查网络连接
5. 连接 Ollama 失败
6. 确保 Ollama 正在运行 (ollama serve)
7. 确认模型是否已安装 (ollama list)
8. 查询执行错误
9. 检查数据库权限
10. 确认模式中的表/列名是否正确

使用教程

使用依赖

• Node.js 16 或更高版本
• 运行中的 PostgreSQL 数据库
• 本地安装并运行的 Ollama
• 在 Ollama 中拉取 qwen2.5-coder:7b-instruct 模型

安装命令:

# 安装 Node.js (根据系统选择适当方式)
# 安装 PostgreSQL (根据系统选择适当方式)
# 安装 Ollama (参考 https://ollama.ai)

安装教程

1. 克隆仓库:

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

1. 安装依赖:

npm install

1. 拉取所需的 Ollama 模型:

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

1. 在项目根目录创建 .env 文件:

DATABASE_URL=postgresql://user:password@localhost:5432/dbname
OLLAMA_MODEL=qwen2.5-coder:7b-instruct  # 可选 - 这是默认值

调试方式

1. 启动聊天界面:

npm start

1. 用自然语言提问关于数据的问题:

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

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

[AI 将生成并执行 SQL 查询，然后解释结果]

1. 输入 'exit' 退出应用。

许可证

该项目遵循 MIT 开源许可条款。