数据库CRUD服务器

一个轻量级的MCP服务器,用于在本地SQLite数据库上执行CRUD操作,支持Claude Desktop集成和通过Ollama使用qwen:14b模型进行AI代理控制。

  • by RaviMehta90
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ravimehta90/simple-db-mcp-server

使用说明

简单DB MCP服务器

一个用Python构建的轻量级MCP(模型上下文协议)服务器,用于在本地SQLite数据库上执行CRUD操作。专为快速迭代、Claude Desktop集成和通过Ollama使用工具调用功能进行AI代理控制而设计 qwen:14b 模型。


🚀 特性

  • 符合MCP的Python服务器
  • SQLite数据库(mcp_ecommerce.db)
  • 通过以下方式与Claude Desktop兼容 uv run mcp install
  • 用于测试本地交互的客户端脚本
  • Ollama与通过启用的工具调用兼容 qwen:14b
  • 用干净的方式管理 uv 和 pyproject.toml --无需pip

📁 项目结构

simple-db-mcp-server/
├── db.py             # SQLite utility functions
├── server.py         # MCP server logic
├── client.py         # Example MCP client
├── mcp_ecommerce.db  # Sample database
├── pyproject.toml    # Project & dependency config
├── .gitignore
├── LICENSE
└── README.md

⚙️ 需求


🧠 设立Ollama&Qwen

确保你有 没有 在启动服务器或通过代理进行交互之前安装并运行。

1.安装Olama

curl -fsSL https://ollama.com/install.sh | sh

或者从以下网址下载: https://ollama.com/download

2.拉取工具调用模型: qwen:14b

ollama pull qwen:14b

qwen:14b 是一个强大的开源LLM,支持函数/工具调用,这是AI代理调用此MCP服务器所必需的。


⚙️ 项目设置 uv

1.安装 uv

curl -Ls https://astral.sh/uv/install.sh | bash

2.克隆和导航

git clone https://github.com/RaviMehta90/simple-db-mcp-server.git
cd simple-db-mcp-server

3.创建和激活虚拟环境

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

4.安装依赖项

uv sync

🖥️ 在Claude Desktop注册服务器

uv run mcp install server.py

✅ 输出示例

[07/07/25 21:35:38] INFO     Added server 'ecommerce-sqlite' to Claude config
                    INFO     Successfully installed ecommerce-sqlite in Claude app

🧪 运行客户端

要通过命令行客户端与MCP服务器交互,请执行以下操作:

uv run client.py

🗃️ 示例数据库

SQLite文件 mcp_ecommerce.db 包含预填充的表(例如用户、产品)。您可以使用任何SQLite查看器或使用:

sqlite3 mcp_ecommerce.db

📜 许可证

该项目根据 MIT许可证.


🙋 支持

欢迎提出问题、想法或贡献!
联系 @拉维梅塔90 或者打开一个问题。