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