sqlite-mcp-server-enhanced-filterable

# SQLite MCP 服务器 最后更新时间：2025年11月24日 - 生产/稳定版 v2.6.3 * 企业级 SQLite，具备 AI 原生 JSON 操作和智能工作流自动化 – v2.6.3 * [](https://github.com/neverinfamous/sqlite-mcp-server) [](https://hub.docker.com/r/writenotenow/sqlite-mcp-server) [](https://opensource.org/licenses/MIT)   [](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.neverinfamous/sqlite-mcp-server) [](https://pypi.org/project/sqlite-mcp-server-enhanced/) [](SECURITY.md) [](https://github.com/neverinfamous/sqlite-mcp-server/security/code-scanning) [](https://github.com/neverinfamous/sqlite-mcp-server) 将 SQLite 转化为强大的、适用于 AI 的数据库引擎，具备 **73 种专项工具**，用于高级分析、JSON 操作、文本处理、向量搜索、地理空间操作和智能工作流自动化。 <!-- mcp-name: io.github.neverinfamous/sqlite-mcp-server --> --- ## 📋 目录 ### 快速开始 - [✅ 快速测试 - 验证所有功能](#-快速测试---验证所有功能) - [🚀 快速开始](#-快速开始) - [🔥 核心功能](#-核心功能) - [🏢 企业功能](#-企业功能) ### 配置与使用 - [📚 MCP 客户端配置](#-mcp-客户端配置) - [🎨 使用示例](#-使用示例) - [📊 工具分类](#-工具分类) ### 资源与信息 - [🏆 为什么选择 SQLite MCP 服务器？](#-为什么选择-sqlite-mcp-服务器) - [🔍 AI 驱动的维基搜索](#-ai-驱动的维基搜索) - [📚 完整文档](#-完整文档) - [🔗 更多资源](#-更多资源) - [🚀 快速链接](#-快速链接) - [📈 项目统计](#-项目统计) --- ## ✅ **快速测试 - 验证所有功能** **在 30 秒内测试所有 73 种工具！** 快速测试： ```bash python test_runner.py --quick ``` 标准综合测试（推荐）： ```bash python test_runner.py --standard ``` 完整测试套件，包含边缘情况： ```bash python test_runner.py --full ``` **预期输出：** ```plaintext 🚀 SQLite MCP 服务器综合测试套件 v2.6.3 ================================================================ 🔍 环境检测： ✅ SQLite 3.50.4 (支持 JSONB) ✅ Python 3.13.x ✅ MCP 1.14.0 ✅ Pyright 严格类型检查：通过 📊 测试 73 种工具，涵盖 14 个类别... ✅ 核心数据库操作（8/8 通过） ✅ JSON 助手工具（6/6 通过） ✅ JSON 操作（12/12 通过） ✅ 文本处理（8/8 通过） 🎉 成功：所有 73 种工具测试成功！ ``` ### 🛡️ **安全测试** **新增：全面 SQL 注入保护测试** 在测试目录中测试 SQL 注入保护： ```bash cd tests && python test_sql_injection.py ``` 预期结果：🛡️ 总体安全态势：强 **测试内容：** - 保护措施，防止原始 Anthropic SQLite MCP 服务器中发现的 SQL 注入漏洞 - 11 种不同的攻击向量，包括多语句、UNION 注入、盲注入 - 参数绑定保护，带有恶意 payload - 堆叠查询和基于注释的注入尝试 [⬆️ 返回目录](#-table-of-contents) ## 🚀 **快速开始** ### **选项 1：Docker（推荐）** 拉取并立即运行： ```bash docker pull writenotenow/sqlite-mcp-server:latest ``` 运行并挂载卷： ```bash docker run -i --rm \ -v $(pwd):/workspace \ writenotenow/sqlite-mcp-server:latest \ --db-path /workspace/database.db ``` #### 🛡️ **供应链安全** 为了增强安全性和可复制的构建，使用 SHA 固定的镜像： 在 https://hub.docker.com/r/writenotenow/sqlite-mcp-server/tags 上查找可用的 SHA 标签 查找以 "master-" 或 "sha256-" 开头的标签，以进行加密验证的构建 选项 1：人类可读的时间戳构建（推荐） ```bash docker pull writenotenow/sqlite-mcp-server:master-YYYYMMDD-HHMMSS-<commit> ``` 选项 2：多架构清单摘要（最大安全性） ```bash docker pull writenotenow/sqlite-mcp-server@sha256:<manifest-digest> ``` 示例：使用加密验证的镜像运行 ```bash docker run -i --rm \ -v $(pwd):/workspace \ writenotenow/sqlite-mcp-server:master-YYYYMMDD-HHMMSS-<commit> \ --db-path /workspace/database.db ``` **如何查找 SHA 标签：** 1. 访问 [Docker Hub 标签页](https://hub.docker.com/r/writenotenow/sqlite-mcp-server/tags) 2. **为了方便**：使用 `master-YYYYMMDD-HHMMSS-<commit>` 标签（人类可读，多架构安全） 3. **为了最大安全性**：使用 `sha256-<hash>` 标签（清单摘要，不变） **了解 SHA 标签：** - 🏷️ **`master-YYYYMMDD-HHMMSS-<commit>`** - 人类可读，时间戳，多架构安全 - 🔒 **`sha256-<manifest-digest>`** - 多架构清单摘要（适用于所有架构） - ⚠️ **架构特定摘要** - 仅用于调试特定架构 **安全功能：** - ✅ **构建出处** - 构建过程的加密证明 - ✅ **SBOM 可用** - 完整的软件物料清单 - ✅ **供应链证明** - 可验证的构建完整性 - ✅ **可复制的构建** - 准确的镜像验证，以满足合规性要求 ### **选项 2：Python 安装** 从 PyPI 安装： ```bash pip install sqlite-mcp-server-enhanced ``` 或从源码安装： ```bash git clone https://github.com/neverinfamous/sqlite-mcp-server.git ``` 导航到目录： ```bash cd sqlite-mcp-server ``` 安装依赖： ```bash pip install -r requirements.txt ``` 运行服务器： ```bash python start_sqlite_mcp.py --db-path ./database.db ``` ### **选项 3：30 秒测试** 克隆仓库： ```bash git clone https://github.com/neverinfamous/sqlite-mcp-server.git ``` 导航到目录： ```bash cd sqlite-mcp-server ``` 运行快速测试： ```bash python test_runner.py --quick ``` ### **🆕 新增功能：v2.6.0 完整的 JSON 操作套件** **此次发布中的 5 项主要改进：** - 🎯 **JSON 助手工具** - 6 种专项工具，用于简化 JSON 操作，具备路径验证和合并功能 - 🤖 **JSON 自动规范化** - 自动修复 Python 风格的 JSON，具备可配置的严格模式 - 🛡️ **参数绑定接口** - 增强的 MCP 工具，具备 SQL 注入防护 - 📦 **自动参数序列化** - 直接对象/数组参数，无需手动 JSON.stringify() - 🧠 **增强的 JSON 错误诊断** - 智能错误分类，提供上下文指导 --- ## ⚡ **安装到 Cursor IDE** ### **一键安装** 点击以下按钮，直接安装到 Cursor： [](cursor://anysphere.cursor-deeplink/mcp/install?name=SQLite%20MCP%20Server&config=eyJzcWxpdGUtbWNwIjp7ImFyZ3MiOlsicnVuIiwiLWkiLCItLXJtIiwiLXYiLCIkKHB3ZCk6L3dvcmtzcGFjZSIsIndyaXRlbm90ZW5vdy9zcWxpdGUtbWNwLXNlcnZlcjpsYXRlc3QiLCItLWRiLXBhdGgiLCIvd29ya3NwYWNlL3NxbGl0ZV9tY3AuZGIiXSwiY29tbWFuZCI6ImRvY2tlciJ9fQ==) 或复制此深链接： ```plaintext cursor://anysphere.cursor-deeplink/mcp/install?name=SQLite%20MCP%20Server&config=eyJzcWxpdGUtbWNwIjp7ImFyZ3MiOlsicnVuIiwiLWkiLCItLXJtIiwiLXYiLCIkKHB3ZCk6L3dvcmtzcGFjZSIsIndyaXRlbm90ZW5vdy9zcWxpdGUtbWNwLXNlcnZlcjpsYXRlc3QiLCItLWRiLXBhdGgiLCIvd29ya3NwYWNlL3NxbGl0ZV9tY3AuZGIiXSwiY29tbWFuZCI6ImRvY2tlciJ9fQ== ``` ### **先决条件** - ✅ 已安装并运行 Docker - ✅ 可用磁盘空间约 500MB ### **配置** 安装后，Cursor 将使用此基于 Docker 的配置： ```json { "sqlite-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "-v", "$(pwd):/workspace", "writenotenow/sqlite-mcp-server:latest", "--db-path", "/workspace/sqlite_mcp.db" ] } } ``` **📖 [查看完整安装指南 →](https://github.com/neverinfamous/sqlite-mcp-server/wiki/Installation-and-Configuration)** --- ## 🔥 **核心功能** - 📊 **统计分析** - 描述性统计、分位数、时间序列分析 - 🔍 **高级文本处理** - 正则表达式、模糊匹配、语音搜索、相似度 - 🧠 **向量/语义搜索** - AI 原生嵌入、余弦相似度、混合搜索 - 🗺️ **SpatiaLite 地理空间** - 企业级 GIS，具备空间索引和操作 - 🔐 **事务安全性** - 自动包装事务，具备回滚保护 - 🎛️ **73 种专项工具** - 完整的数据库管理和分析套件 ### 🏢 **企业功能** - 📈 **商业智能** - 集成洞察备忘录和工作流自动化 - 🔄 **备份/恢复** - 企业级操作，具备完整性验证 - 🎯 **全文搜索 (FTS5)** - 高级搜索，具备 BM25 排名和摘要 - 🏗️ **虚拟表** - 智能 CSV/JSON 导入，具备自动类型推断 - ⚙️ **高级 PRAGMA** - 完整的 SQLite 配置和优化 [⬆️ 返回目录](#-table-of-contents) ## 📚 **MCP 客户端配置** ### **Claude Desktop** ```json { "mcpServers": { "sqlite-mcp-server": { "command": "python", "args": ["/path/to/sqlite-mcp-server/start_sqlite_mcp.py", "--db-path", "/path/to/database.db"] } } } ``` ### **使用 Claude Desktop 的 Docker** ```json { "mcpServers": { "sqlite-mcp-server": { "command": "docker", "args": ["run", "-i", "--rm", "-v", "/path/to/project:/workspace", "writenotenow/sqlite-mcp-server:latest", "--db-path", "/workspace/database.db"] } } } ``` [⬆️ 返回目录](#-table-of-contents) ## 🎨 **使用示例** ### **数据分析工作流** 1. 快速验证： ```bash python test_runner.py --quick ``` 2. 使用您的数据： ```bash python start_sqlite_mcp.py --db-path ./sales_data.db ``` 3. 与 Claude/Cursor 一起使用： - 数据集的统计分析 - 文本处理和模式提取 - 向量相似度搜索 - 地理空间分析和映射 - 商业智能洞察 ### **Docker 开发** 开发并实时加载： ```bash docker run -i --rm \ -v $(pwd):/workspace \ -e SQLITE_DEBUG=true \ writenotenow/sqlite-mcp-server:latest \ --db-path /workspace/dev.db ``` ### 🎯 **JSON 助手工具 - 简化的 JSON 操作** **v2.6.0 新增功能：** 六种强大的 JSON 助手工具，使复杂的 JSON 操作变得简单： ```javascript // ✅ 插入 JSON 自动规范化 json_insert({ "table": "products", "column": "metadata", "data": {'name': 'Product', 'active': True, 'price': None} }) // ✅ 按路径更新 JSON json_update({ "table": "products", "column": "metadata", "path": "$.price", "value": 29.99, "where_clause": "id = 1" }) // ✅ 查询 JSON 复杂过滤 json_query({ "table": "products", "column": "metadata", "filter_paths": {"$.category": "electronics"}, "select_paths": ["$.name", "$.price"] }) ``` **JSON 助手工具：** - 🎯 **json_insert** - 插入 JSON 数据，自动规范化 - 🔄 **json_update** - 按路径更新 JSON，支持创建 - 🔍 **json_select** - 提取 JSON 数据，支持多种输出格式 - 🔎 **json_query** - 复杂的 JSON 过滤和聚合 - ✅ **json_validate_path** - 验证 JSON 路径，具备安全检查 - 🔗 **json_merge** - 合并 JSON 对象，冲突解决 **自动规范化仍然有效： - 🔧 单引号 → 双引号 - 🔧 Python `True`/`False` → JSON `true`/`false` - 🔧 Python `None` → JSON `null` - 🔧 Trailing commas removed - 🛡️ Security validation prevents malicious input ### **🧠 增强的 JSON 错误诊断** **v2.6.0 增强功能：** 当 JSON 验证失败时，获得智能化的上下文错误消息，提供具体指导： ```javascript // ❌ 无效的 JSON 输入： validate_json('{key_without_quotes: "value"}') // ✅ 增强的错误响应： { "valid": false, "error": "Expecting property name enclosed in double quotes: line 1 column 2 (char 1)", "enhanced_message": "JSON validation failed (structural_syntax): Expecting property name...", "error_context": { "error_type": "structural_syntax", "security_concern": false, "suggestions": [ "Ensure all object keys are properly quoted strings", "Check for missing colons (:) between keys and values", "Verify proper key-value pair structure: \"key\": \"value\"" ] } } ``` **增强的错误类别：** - 🔧 **结构问题** - 缺失引号、冒号、括号，具备具体的修复建议 - 🛡️ **安全警告** - 检测 JSON 字符串中潜在的 SQL 注入模式 - 📝 **编码问题** - 字符编码和转义序列指导 - 🎯 **上下文提示** - 行/列位置，具备有针对性的建议 ### **🛡️ 增强的参数绑定 + 自动序列化** **v2.6.0 新增功能：** 具备自动 JSON 序列化，具备 SQL 注入防护： ```javascript // ✅ 安全：参数绑定防止注入 read_query({ "query": "SELECT * FROM users WHERE name = ? AND age > ?", "params": ["John", 25] }) // ✅ 新增：直接对象/数组参数（自动序列化） write_query({ "query": "INSERT INTO products (metadata, tags) VALUES (?, ?)", "params": [ {"name": "Product", "price": 29.99, "active": true}, // 自动序列化为 JSON ["electronics", "featured", "new"] // 自动序列化为 JSON ] }) // ✅ 简化：不再需要手动 JSON.stringify() // 之前 v2.6.0 版本： write_query({ "query": "INSERT INTO table (data) VALUES (?)", "params": [JSON.stringify({"key": "value"})] // 需要手动序列化 }) // 之后 v2.6.0 版本： write_query({ "query": "INSERT INTO table (data) VALUES (?)", "params": [{"key": "value"}] // 自动序列化！ }) // ✅ 简化 API // 无需手动 JSON.stringify() 或参数准备 // 更好的性能 // 清洁的 API ``` ### **📊 工具分类** SQLite MCP 服务器提供 **73 种专项工具**，涵盖 **14 个类别**： > 💡 **想要完整的工具列表吗？** 查看 [**详细工具参考**](https://github.com/neverinfamous/sqlite-mcp-server/wiki/Home) ，包含所有 73 种工具的描述、7 种资源和 7 种提示。 | 类别 | 工具数量 | 描述 | |----------|------------|-------------| | **[核心数据库](./docs/sqlite-mcp-server.wiki/Core-Database-Tools.md)** | 15 | CRUD 操作，模式管理，事务 | | **[JSON 助手工具](./docs/sqlite-mcp-server.wiki/JSON-Helper-Tools.md)** | 6 | 简化的 JSON 操作，路径验证，合并 | | **[文本处理](./docs/sqlite-mcp-server.wiki/Advanced-Text-Processing.md)** | 9 | 正则表达式，模糊匹配，语音搜索，相似度 | | **[统计分析](./docs/sqlite-mcp-server.wiki/Statistical-Analysis.md)** | 8 | 描述性统计，分位数，时间序列 | | **[虚拟表](./docs/sqlite-mcp-server.wiki/Virtual-Tables.md)** | 8 | CSV，R-Tree，序列生成 | | **[语义搜索](./docs/sqlite-mcp-server.wiki/Semantic-Vector-Search.md)** | 8 | 嵌入，相似度，混合搜索 | | **[地理空间](./docs/sqlite-mcp-server.wiki/SpatiaLite-Geospatial.md)** | 7 | 空间索引，几何操作 | | **[PRAGMA 操作](./docs/sqlite-mcp-server.wiki/PRAGMA-Operations.md)** | 5 | 配置，优化，检查 | | **[全文搜索](./docs/sqlite-mcp-server.wiki/Full-Text-Search.md)** | 3 | FTS5 创建，索引，BM25 排名 | | **[向量优化](./docs/sqlite-mcp-server.wiki/Vector-Index-Optimization.md)** | 2 | ANN 搜索，聚类，性能 | | **[数据分析](./docs/sqlite-mcp-server.wiki/Enhanced-Virtual-Tables.md)** | 2 | 智能 CSV/JSON 导入，具备类型推断 | | **[资源](./docs/sqlite-mcp-server.wiki/MCP-Resources-and-Prompts.md)** | 7 | 数据库元感知，性能洞察 | | **[提示](./docs/sqlite-mcp-server.wiki/MCP-Resources-and-Prompts.md)** | 7 | 引导工作流，优化配方 | > 💡 **Cursor 用户：** 您可以在 MCP 客户端设置中仅启用您需要的类别，以减少工具噪音并提高稳定性。每个数字代表该类别中的 **工具数量**。 [⬆️ 返回目录](#-table-of-contents) ## 🏆 **为什么选择 SQLite MCP 服务器？** ✅ **AI 友好** - JSON 自动规范化和智能错误信息减少调试时间 ✅ **即插即用** - 内置安全性和参数绑定，无需配置 ✅ **智能诊断** - 增强的错误上下文提供可行的指导 ✅ **类型安全** - 在 Cursor 中通过严格的 Pyright 类型检查以确保最大代码质量 ✅ **立即测试** - 在 30 秒内验证所有 73 种工具 ✅ **生产就绪** - 企业级测试和验证 ✅ **全面** - 一个软件包中包含您所需的一切 ✅ **Docker 就绪** - 容器化以便于部署 ✅ **零中断变更** - 所有现有代码继续有效 [⬆️ 返回目录](#-table-of-contents) ## 🔍 **AI 驱动的 Wiki 搜索** **[→ 使用 AI 搜索文档](https://search.adamic.tech)** 找不到您要找的内容？使用我们的 **AI 驱动的搜索界面** 来搜索 SQLite 和 PostgreSQL MCP 服务器文档： - 🤖 **自然语言查询** - 用普通英语提问并获得 AI 生成的答案 - ⚡ **即时结果** - 来自两个 wiki 的 AI 增强答案和来源 - 📚 **全面覆盖** - 搜索所有 73 种 SQLite 工具 + 63 种 PostgreSQL 工具（共 136 种） - 🎯 **智能上下文** - 了解技术问题并提供相关示例 - 🔄 **双重搜索模式** - AI 增强以获取综合答案，或原始文档以获取直接内容 **示例查询：** - "如何防止 SQL 注入攻击？" - "有哪些统计分析工具可用？" - "如何使用嵌入式向量搜索？" - "如何使用 JSON 帮助工具进行数据规范化？" - "有哪些 SpatiaLite 地理空间操作可用？" **[→ 立即尝试 AI 搜索](https://search.adamic.tech)** 搜索界面使用 Cloudflare 的 AI 搜索技术，从 SQLite 和 PostgreSQL MCP 服务器的综合 wiki 文档中提供智能、上下文感知的答案。 [⬆️ 返回目录](#-table-of-contents) ## 📚 **完整文档** **[→ Wiki：综合文档和示例](https://github.com/neverinfamous/sqlite-mcp-server/wiki)** 综合文档包括： - **详细工具参考** - 所有 73 种工具及示例 - **高级配置** - 性能调优和优化 - **集成指南** - MCP 客户端、Docker、CI/CD - **功能深入解析** - 文本处理、向量搜索、地理空间 - **最佳实践** - 查询模式、故障排除、工作流程 - **API 参考** - 完整的工具模式和参数 **📰 [阅读 v2.6.0 版本文章](https://adamic.tech/articles/2025-09-22-sqlite-mcp-server-v2-6-0)** - 了解 JSON 操作、自动规范化和增强的安全性 **[→ GitHub Gists：实用示例和用例](https://gist.github.com/neverinfamous/0c8ed77ddaff0edbe31df4f4e18c33ce)** 9 个精选的 Gist，包含现实世界的示例： - **JSON 帮助工具** - 使用自动规范化简化 JSON 操作 - **向量/语义搜索** - AI 原生嵌入和相似性搜索 - **SpatiaLite GIS** - 地理空间操作和空间索引 - **性能优化** - 查询调优和索引建议 - **安全最佳实践** - SQL 注入预防和安全查询 - **现实世界用例** - 商业智能和数据分析工作流程 - **数据库迁移** - 模式演化和数据转换 - **Docker 部署** - 生产容器化策略 - **完整功能展示** - 所有 73 种工具的综合示例 [⬆️ 返回目录](#-table-of-contents) ## 🔗 **其他资源** - **[测试指南](./tests/README.md)** - 综合测试文档 - **[贡献指南](./CONTRIBUTING.md)** - 如何为项目做出贡献 - **[安全策略](./SECURITY.md)** - 安全指南和报告 - **[行为准则](./CODE_OF_CONDUCT.md)** - 社区指南 - **[Docker Hub](https://hub.docker.com/r/writenotenow/sqlite-mcp-server)** - 容器镜像 - **[GitHub 版本](https://github.com/neverinfamous/sqlite-mcp-server/releases)** - 版本历史 - **[Adamic 支持博客](https://adamic.tech/)** - 项目公告和版本 [⬆️ 返回目录](#-table-of-contents) ## 🚀 **快速链接** | 操作 | 命令 | |--------|---------| | **AI 驱动的搜索** | [search.adamic.tech](https://search.adamic.tech) | | **测试所有内容** | `python test_runner.py --standard` | | **Docker 快速入门** | `docker run -i --rm -v $(pwd):/workspace writenotenow/sqlite-mcp-server:latest` | | **从 PyPI 安装** | `pip install sqlite-mcp-server-enhanced` | | **查看完整文档** | [docs/sqlite-mcp-server.wiki](./docs/sqlite-mcp-server.wiki/Home.md) | | **报告问题** | [GitHub 问题](https://github.com/neverinfamous/sqlite-mcp-server/issues) | [⬆️ 返回目录](#-table-of-contents) ## 📈 **项目统计** - **73 种工具**，涵盖 14 个类别（全部经过测试和验证 ✅） - **2,000+ 行**综合文档 - **多平台**支持（Windows、Linux、macOS） - **Docker 镜像**，适用于 amd64 和 arm64 - **严格的类型检查**，使用 Pyright 以确保代码质量 - **企业级测试**，具有综合验证 - **积极开发**，定期更新 [⬆️ 返回目录](#-table-of-contents)