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

______________________________________________________________________

⚙️ 需求

• Python 3.11+
• uv
• Ollama （本地AI推理引擎）
• qwen:14b 模型（支持工具调用）
• 克劳德桌面 （可选）

______________________________________________________________________

🧠 设立Ollama&Qwen

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

1.安装Olama

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

或者从以下网址下载：

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 或者打开一个问题。