Sqlite Tool

🚀 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"
      }
    }
  }
}

调用示例

使用示例：

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

📚 详细文档

目录结构

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

• 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