外观主题
阅读语言

触手怪的 MCP 工具集 —— 一个文件夹一个工具,零依赖

人工智能 创意 3天前 更新于 21小时前
https://yxp.hk/p/x9sRqU

📦 开源仓库:yxpil/TentacleTool

gh-card · yxpil/TentacleTool

📦 仓库名片 · Powered by gh-card


TentacleTool

工具集单仓库(monorepo):一个文件夹 = 一个独立工具集,互不依赖,可单独启动。

每个工具集都是一个零依赖 MCP 服务器(只依赖 Node 原生模块,不装任何 npm 包),
走 MCP Streamable HTTP 协议(2025-03-26),本地监听一个固定端口。

工具集一览

文件夹 工具集 端口 工具数 说明
neton/ NetON 8341 6 局域网网络工具(设备发现 / 端口扫描 / 协议分析 / 抓包)
webview/ WebView 8342 4 网页转 Markdown(网页转 MD / HTML 转 MD / 链接提取 / 元信息提取)
search/ Search 8343 3 聚合搜索(必应/百度/DuckDuckGo,折叠摘要 + 翻页 + 按需展开全文)
find/ Find 8344 4 本机文件搜索(Everything 风格:文件名 / 最近修改 / 内容检索 / 工具定位,可选 C 原生索引器加速)
calc/ Calc 8345 5 科学计算器(表达式求值 / 单位换算 / 方程与方程组 / 矩阵运算,手写零依赖引擎)
analyze/ Analyze 8346 8 代码知识图谱(符号搜索 / 引用 / 调用链 / 依赖与循环检测 / 最短路径 / 影响面分析,11 种语言零依赖提取器)
kb/ KB 8347 6 MySQL 知识库(把多张表组合成一个有业务含义的知识库:跨库跨源组合 / 跨表全文搜索 / 只读 SQL / 结构内省,零依赖自实现 MySQL 客户端协议)
stamp/ Stamp 8348 6 时间与调度(时间戳转换 / 时长解析 / 时区换算含 DST / 工作日推算含调休 / cron 解析与触发预测,纯 Intl 实现时区运算)
jsonx/ Jsonx 8349 6 数据格式处理(JSON/YAML/CSV/TSV 互转含往返校验 / JSONPath 查询 / 结构推断 / 结构化 diff / 统计聚合,CSV 走完整状态机、类型推断保守化)
fsx/ Fsx 8350 10 文件系统操作(读 / 写 / 精确替换 / 列目录 / 目录树 / 属性 / 内容检索 / 复制 / 移动 / 带四道安全闸门的删除)
gitx/ Gitx 8351 10 Git 仓库操作(状态 / 历史 / 差异 / 逐行归属 / 文件历史 / 分支 / 暂存 / 远程 / 提交,刻意不做 push 与任何改写历史的操作)
httpx/ Httpx 8352 6 HTTP 客户端(通用请求 / 下载 / 头探测 / 并发批量 / JSON API / 站点探测,含 SSRF 防护与内网拦截)
cryptox/ Cryptox 8353 9 哈希 / 编码 / 加密(摘要 / HMAC / 文件校验和 / 编解码 / JWT 解析验签 / UUID 与短 ID / 密码生成与强度评估 / AES-256-GCM 加解密,全程本地无网络)

下一个新工具集用 8354。测试端口约定:18000 + 正式端口(如 8348 → 18348、8353 → 18353)。

快速开始

每个工具集自带独立的 `pac

🛠 技术栈与开发

  • 开发语言:Node.js(零 npm 依赖,只用原生模块);find/ 附带可选 C 原生索引器加速大目录
  • 架构:monorepo 一个文件夹 = 一个独立 MCP Streamable HTTP 服务器(2025-03-26 协议),固定端口 8341–8353,互不依赖可单独启动
  • 质量:单测 1488 项 + 端到端 598 项全部通过(npm test / node test/mcp.e2e.js),依赖不可用时优雅跳过而非失败
  • 设计约定:上下文经济(输出折叠 + 限条数 + 翻页续读)、失败可诊断(错误说清怎么改)、凭据文件一律不入库

📚 文档与链接

  • 仓库:https://github.com/yxpil/TentacleTool(每个工具集文件夹自带独立 README 与 start.bat)
  • 端口速查:8341 neton · 8342 webview · 8343 search · 8344 find · 8345 calc · 8346 analyze · 8347 kb · 8348 stamp · 8349 jsonx · 8350 fsx · 8351 gitx · 8352 httpx · 8353 cryptox(新工具集自 8354 起,测试端口 = 18000 + 正式端口)
  • 启动:进文件夹 node src/index.js(或双击 start.bat);端口可用环境变量覆盖(如 $env:KB_PORT=9347);MCP 客户端按 Streamable HTTP 添加 http://127.0.0.1:8347/ 即可