简单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或者从以下网址下载:
2.拉取工具调用模型: qwen:14b
ollama pull qwen:14bqwen: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 或者打开一个问题。
