Ollama MCP 数据库助手

交互式聊天界面，将 Ollama 的 LLM 功能与通过模型上下文协议 (MCP) 访问 PostgreSQL 数据库相结合。您可以使用自然语言提出有关数据的问题，并获得由真实 SQL 查询支持的 AI 响应。

特征

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

先决条件

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

设置

1. 克隆存储库：

2. 安装依赖项：

3. 拉取需要的Ollama模型：

4. 在项目根目录中创建一个.env文件：

用法

1. 启动聊天界面：

2. 使用自然语言询问有关数据的问题：

3. 输入“exit”退出应用程序。

工作原理

1. 该应用程序通过PostgreSQL MCP 服务器连接到您的 PostgreSQL 数据库
2. 它加载并缓存你的数据库模式
3. 当你问一个问题时：
   • 模式和问题已发送给 Ollama
   • Ollama 生成适当的 SQL 查询
   • 通过 MCP 执行查询
   • 结果发回Ollama进行解释
   • 您会收到自然语言回复

环境变量

安全

• 所有数据库访问都是只读的
• SQL 查询仅限于 SELECT 语句
• 数据库凭证安全地保存在您的 .env 文件中

发展

内置：

• TypeScript
• 模型上下文协议（MCP）
• 奥拉马
• PostgreSQL

故障排除

常见问题

1. “无法连接到数据库”
   • 检查 .env 中的 DATABASE_URL
   • 验证 PostgreSQL 是否正在运行
   • 检查网络连接
2. “无法连接到 Ollama”
   • 确保 Ollama 正在运行（ ollama serve ）
   • 验证模型是否已安装（ ollama list ）
3. “执行查询时出错”
   • 检查数据库权限
   • 验证架构中的表/列名称

执照

麻省理工学院

贡献

1. 分叉存储库
2. 创建你的功能分支
3. 提交你的更改
4. 推送到分支
5. 打开拉取请求