JinDaGe - sqlite-tool MCP Details

article

README

🚀 SQLite MCP 工具（仅删除功能）

本项目是一个基于 Python 开发的 MCP 工具，其核心功能为 删除 SQLite 表数据（delete_rows）。调用者可通过指定数据库路径、表名以及简单的等值过滤条件，轻松执行 DELETE 操作。

✨ 主要特性

精准删除：提供 delete_rows 方法，可从指定的 SQLite 数据库表中精准删除符合条件的记录。
- 必填参数：
  - db_path：数据库路径，明确指定要操作的数据库位置。
  - table：表名，指定要进行数据删除操作的表。
- 可选参数：
  - filters：简单等值条件字典，用于进一步筛选要删除的记录。
  - allow_full_table：是否允许整表删除，为数据操作提供更多灵活性。

📦 安装指南

安装依赖

建议在虚拟环境中安装依赖，操作步骤如下：

cd agent-cli
pip install -r requirements.txt

💻 使用示例

基础用法

启动 MCP 服务器

启动 MCP 服务器的示意命令如下（具体集成方式需根据你的 Agent/宿主情况调整）：

cd agent-cli
python -m sqlite_mcp.server

在支持 MCP 的 Agent 中注册服务

在支持 MCP 的 Agent 中注册该服务，并调用 delete_rows 方法。以下是 cursor 注册示例：

{
  "mcpServers": {
    "user-sqlite-delete-tool": {
      "command": "/Users/XXX/.mcp/sqlite-tool/.venv/bin/python",
      "args": [
        "-m",
        "sqlite_mcp.server"
      ],
      "env": {
        "PYTHONPATH": "/Users/XXX/.mcp/sqlite-tool/agent-cli"
      }
    }
  }
}

img/img_1.png

调用示例

使用示例：

@user-sqlite-delete-tool，帮我删除路径为/Users/XXX/XXX.db，表名为BBB，字段名id为CCC的记录

img/img.png

📚 详细文档

目录结构

本项目的目录结构清晰，各部分分工明确，具体如下：

agent-cli/
- README.md：项目说明文档，提供项目的基本信息和使用指南。
- requirements.txt：Python 依赖文件，列出了项目所需的 Python 包。
- sqlite_mcp/：主源码目录，包含项目的核心代码。
  - __init__.py
  - server.py：MCP 工具服务实现与入口，负责启动服务和处理请求。
  - delete_tool.py：核心删除逻辑文件，实现了数据删除的具体功能。
- docs/
  - delete_rows_spec.md：delete_rows 方法需求与接口说明文档，详细介绍了该方法的使用方式和参数说明。
- tests/
  - test_delete_rows.py：简单单测文件，可通过以下命令运行测试：

python tests/test_delete_rows.py

sqlite-tool