Provides Git version control operations including status, diff, log, add, commit, push, pull, branch, stash, and remote management.
Offers Markdown rendering to HTML, table of contents generation, link extraction, and link validation.
Enables interaction with SQLite databases, supporting table listing, schema inspection, read-only queries, write operations, and paginated data retrieval.
Provides tools for editing and validating YAML files.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@LuzzyTool List files in the current directory"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
English version also available · 也提供英文版
基于 MCP (Model Context Protocol) 的本地系统工具集，为 AI 助手提供 70+ 工具，涵盖文件操作、Shell 执行、代码搜索、文件监听、压缩解压、HTTP 请求、Git 操作、SQLite 数据库、网络诊断和 Markdown 渲染。
Python 3.10+
Windows、macOS 或 Linux
Related MCP server: mcp-toolkit
pip install luzzy-tooluvx luzzy-toolgit clone https://github.com/LuzzyMeow/LuzzyTool.git
cd LuzzyTool
pip install -e .{
"mcpServers": {
"luzzy-tool": {
"command": "uvx",
"args": ["luzzy-tool"]
}
}
}{
"mcpServers": {
"luzzy-tool": {
"command": "luzzy-tool"
}
}
}将以下配置添加到你的 MCP 客户端。必须使用绝对路径，将示例路径替换为你的实际项目路径。
{
"mcpServers": {
"luzzy-tool": {
"command": "/home/user/LuzzyTool/venv/bin/python",
"args": ["-m", "src.server"],
"env": {
"LUZZY_TOOL_HOME": "/home/user/LuzzyTool"
}
}
}
}Windows 用户（例如克隆到 D:\\Projects\\）：
{
"mcpServers": {
"luzzy-tool": {
"command": "D:\\Projects\\LuzzyTool\\venv\\Scripts\\python.exe",
"args": ["-m", "src.server"],
"env": {
"LUZZY_TOOL_HOME": "D:\\Projects\\LuzzyTool"
}
}
}
}将路径替换为你的实际项目位置。
command必须指向 venv 中的python（Windows 为python.exe），LUZZY_TOOL_HOME指向项目根目录。
参考 MCP 安装指南，使用上述配置。
将上述配置添加到 MCP 设置中。
在项目根目录创建 .env 文件（参考 .env.example）：
LOG_LEVEL=INFO # DEBUG | INFO | WARNING | ERROR
CHUNK_SIZE=500 # 检索文本分块大小
CHUNK_OVERLAP=100 # 分块重叠量
DEFAULT_TOP_K=5 # 默认返回结果数也可通过 MCP 客户端 env 字段注入环境变量。
LuzzyTool 提供 70 个 MCP 工具，涵盖 14 个类别。工具名使用英文标识以保证跨客户端兼容性。
类别 | 工具 |
文件操作 |
|
Shell 执行 |
|
文档编辑 |
|
结构化编辑 |
|
检索 |
|
代码搜索 |
|
文件监听 |
|
压缩解压 |
|
HTTP |
|
Git |
|
数据库 |
|
网络诊断 |
|
Markdown |
|
元工具 |
|
工具 | 说明 |
| 列出目录内容，支持递归 |
| 读取文本文件（自动检测编码，最大 100MB） |
| 写入/覆盖文件 |
| 创建目录（含父目录） |
| 移动文件或目录 |
| 复制文件 |
| 删除文件 |
| 按文件名模式或内容正则搜索 |
| 获取文件大小、修改时间、权限、编码 |
| 重命名文件或目录 |
| 批量删除（数组接口） |
| 批量复制，可保持目录结构 |
| 创建文件备份 |
| 从备份恢复文件 |
| 列出所有备份 |
工具 | 说明 |
| 执行单条命令，支持超时、工作目录、系统 Shell 模式 |
| 批量执行命令，可配置遇错停止 |
| 执行命令并自动解析输出 |
| 获取系统信息（OS、CPU、内存、磁盘） |
| 设置会话级环境变量 |
| 获取环境变量 |
| 查询命令执行历史 |
| 清空命令历史 |
| 启动后台进程 |
| 列出所有后台进程 |
| 终止后台进程 |
工具 | 说明 |
| 仓库状态（分支、暂存、未跟踪） |
| 查看差异（暂存区/工作区/文件级统计） |
| 提交日志（结构化输出） |
| 暂存文件 |
| 提交更改 |
| 推送远程（受保护分支防护） |
| 拉取更新（支持 rebase） |
| 分支管理（list/create/delete/rename） |
| Stash 管理（list/save/pop/apply/drop/clear） |
| 远程仓库管理（list/add/remove/get-url） |
工具 | 说明 |
| 列出所有表及行数 |
| 查看表结构（列、索引、主键、DDL） |
| 只读查询（SELECT/PRAGMA/EXPLAIN），参数化 |
| 写入操作（INSERT/UPDATE/DELETE/CREATE/ALTER/DROP） |
| 分页获取表数据，支持 WHERE/ORDER BY |
工具 | 说明 |
| Ping 检测（跨平台，延迟/丢包统计） |
| DNS 查询（A/AAAA/CNAME/MX/NS/TXT/SOA/SRV） |
| TCP 端口扫描（最多 100 端口，服务名识别） |
| TCP 连通性检测（可达性 + 延迟） |
| 反向 DNS 查询（IP → 域名） |
工具 | 说明 |
| Markdown → HTML（支持表格、代码块、脚注等扩展） |
| 生成目录（标题列表 + HTML） |
| 提取链接和图片 |
| 检查链接有效性（本地 + 可选 HTTP） |
压缩解压（4）： archive_create, archive_extract, archive_list, archive_test
文件监听（4）： watch_start, watch_stop, watch_list, watch_events
文档编辑（3）： get_paragraphs, edit_paragraph, edit_by_heading
结构化编辑（4）： edit_json, edit_yaml, validate_json, validate_yaml
检索（2）： retrieve_from_local_files, clear_retrieval_cache
代码搜索（1）： code_search
HTTP（1）： http_request
4 个内置提示词模板：
提示词 | 参数 | 说明 |
|
| 代码审查——bug、安全、风格、性能 |
|
| 项目结构概览和技术栈分析 |
|
| 根据暂存区变更生成 Conventional Commits 提交信息 |
|
| 深度分析文件内容，给出建议 |
3 个资源端点：
URI | 名称 | 类型 |
| 项目 README | text/markdown |
| 工具列表 (JSON) | application/json |
| 项目配置 (pyproject.toml) | text/plain |
路径穿越防护：拒绝 ../ 越权访问
文件读取限制：最大 100MB；超过 1MB 自动限制 500 行/次
参数校验：单参数 10MB，总计 50MB
压缩解压防护：Zip-slip 路径穿越检测
Git 保护分支：master/main force push 拦截
HTTP 安全：默认禁止内网/回环地址；响应体限制 10MB
数据库隔离：读写工具分离；查询使用 ?mode=ro；参数化 SQL
Shell 安全：子进程使用 stdin=DEVNULL 防挂起
详见 SECURITY.md。
LuzzyTool/
├── src/
│ ├── server.py # MCP 入口，工具注册与调度
│ ├── config.py # 全局配置
│ ├── modules/ # ~15 个工具模块
│ ├── utils/path_security.py # 路径安全校验
│ └── database/chroma_manager.py # Chroma 向量数据库
├── scripts/ # 测试与调试脚本
├── tests/
├── pyproject.toml
├── server.json # MCP Registry 元数据
├── lhm.plugin.json # LobeHub 市场清单
├── CLAUDE.md
├── README.md # 中文说明（本文件）
├── README.en.md # English version
├── SECURITY.md
├── CONTRIBUTING.md
├── CHANGELOG.md
└── LICENSEMIT — 详见 LICENSE。
This server cannot be deployed
Stateless agentic tools over MCP: concept extraction, long-context, knowledge graph, planning.
Shared long-term memory vault for AI agents with 20 MCP tools.
65+ AI tools as MCP: research, write, code, scrape, translate, RAG, agent memory, workflows
Cross-tool persistent memory and context for AI assistants over MCP.
