Textavia Mcp

Textavia CLI

快速、本地优先的命令行工具包，涵盖文本、数据、编码、格式化和开发者实用工具。它基于共享的工具注册表构建，确保 CLI、文档、MCP 服务和 Agent 清单始终保持一致。

它是什么

Textavia 是一组通过一个 CLI 提供的小型、可组合开发者工具。 它面向那些使用频率高到不值得打开浏览器标签页，又繁琐到不想每次都重写一次性 Shell 片段的工作：格式化 JSON、解码 Base64、清理粘贴的文本、转换 CSV、计算文件哈希、测试正则表达式、生成 UUID、清除私密字符串，以及准备便于 Agent 读取的 JSON 输出。

npm 包也可作为 Agent 分发资源。安装 textavia 会提供 txv / textavia 二进制文件，以及为 Pi、Hermes、OpenClaw 和其他基于技能的 Agent 系统打包的 SKILL.md 说明。

为什么选择 Textavia CLI

• 本地优先且注重隐私。 标准命令在本地处理输入。无需账户、无需 API 密钥、无遥测，也不会在后台静默访问网络。
• 可组合。 兼容 Unix 的 stdin/stdout、稳定的退出代码，不会对文件作出意外解释。
• 适用于 Agent。 确定性的 JSON 输出、稳定的工具 ID，以及从注册表生成的清单。
• 可扩展。 默认配置轻量；较重的格式化器和媒体工具以可选插件形式提供。

安装

npm install -g textavia
# or
pnpm add -g textavia

该包同时提供 textavia 和 txv 二进制文件。

快速示例

txv case slug "Hello World!"          # hello-world
echo "HeLLo" | txv case lower         # hello
txv hash sha256 abc                   # ba7816bf...
txv json format --file package.json --write  # pretty-print in place
txv base64 encode "Hello"             # SGVsbG8=
txv random uuid                       # a UUID v4

命令模型

txv <namespace> <operation> [input] [options]
txv run <tool-id> [input] [options]
txv tools list | search <q> | info <id> | docs <id>
txv agent run <tool-id> | txv agent manifest

面向用户时使用简短的命名空间形式：

txv json format '{"a":1}'
txv base64 decode SGVsbG8=
txv text clean --file notes.txt

面向脚本和 Agent 时使用规范的工具 ID：

txv run dev.json.format '{"a":1}' --json
txv run encoding.base64.decode SGVsbG8= --json
txv run text.privacy-scrub --file support-log.txt --json

运行 txv tools list 查看所有工具。仓库文档请参阅 docs/README.md，生成的命令参考请参阅 docs/cli.md，完整的注册表元数据请参阅 docs/registry.md。

工具系列

Textavia 目前涵盖以下工具系列：

系列	示例
大小写与文本	slug、camelCase、标题大小写、清理、纯文本、统计信息、隐私清除
编码	Base64、URL 编码、十六进制、二进制、UTF-8、罗马数字
数据格式	JSON、CSV、YAML、TOML、XML、HTML、Markdown 表格
开发者实用工具	哈希、JWT 解码、正则表达式测试/说明、时间戳、cron、UTM URL、QR SVG
行与列表	修剪、排序、去重、比较、求交集、相减、随机打乱
随机生成器	UUID、密码、整数、日期、布尔值、选项
可选插件	代码格式化器、Unicode/文本样式、媒体/PDF/OCR 助手

位置字符串会被视为文本，而不是文件路径：

txv case slug "my file.txt"

这会将字面字符串 my file.txt 转换为 slug。使用 --file 从磁盘读取：

txv case slug --file title.txt

输入与输出

输入优先级：--input、--file、位置参数、stdin、交互式提示（仅人类模式）。

txv case upper --file notes.txt              # read a file
txv json format --file notes.json --write --backup  # in place with a .bak
txv hash sha256 --file big.bin               # streamed, memory-bounded
txv case lower "Hi" --out result.txt         # write to a file

JSON 输出

txv case lower "Hi" --json

{
  "ok": true,
  "tool": "case.lower",
  "inputType": "text",
  "outputType": "text",
  "output": "hi",
  "meta": { "durationMs": 1 }
}

错误也采用结构化形式。退出代码：0 成功，1 用法/验证错误，2 文件 I/O 错误，3 解析错误，4 转换错误，5 需要网络，6 已阻止不安全操作，7 缺少插件，130 已中断。

使用示例

使用注册表工具 ID 命名的流水线（参见 docs/recipes.md）：

txv recipe clean-keywords --file keywords.txt
txv recipe json-api '{"name":"Ada"}' --json

内置配方：seo-slugs、clean-keywords、normalize-lines、 safe-filenames、json-api、csv-clean。

MCP 服务

MCP 包提供由注册表生成的工具，并执行与 CLI 相同的核心工具实现。

npx @textavia/mcp

参见 docs/mcp.md。

Agent 技能

textavia npm 包在 skills/ 下打包了 SKILL.md 文件夹，仓库也在根目录的 skills/ 目录中镜像了这些文件，方便通过 GitHub 发现。 Pi 可以直接从 npm 加载：

pi install npm:textavia

兼容 skills.sh 的 Agent 可以直接从 GitHub 安装仓库中的技能：

npx skills add Caravaca-Labs/textavia-cli --skill '*' --yes

请参阅 docs/agent-skills.md，了解包含的技能、运行时行为和安全规则。

在线工具

更喜欢浏览器界面？

• Textavia
• Textavia JSON 格式化工具
• Textavia Base64 工具
• Textavia 文本清理工具
• Textavia 隐私信息清理工具
• Textavia CSV 转 JSON 转换器

文本样式工具：

• Textavia 故障风格文本转换器
• Textavia Discord 字体生成器
• Textavia 镜像文本生成器
• Textavia 小写转换器
• Textavia 美学文本生成器
• Textavia Instagram 字体
• Textavia 隐形文本生成器
• Textavia 下划线移除工具
• Textavia 宽体文本生成器
• Textavia Zalgo 文本生成器

隐私

• 默认关闭网络；网络工具需要 --allow-network。
• 密码和 UUID 使用密码学安全的随机数。
• 文件写入是原子操作（临时文件 + 重命名）；--backup 会先创建 .bak 文件。
• JWT 解码不代表会验证签名；正则表达式在独立工作线程中运行，并设有超时。

开发

pnpm install
pnpm build
pnpm test
pnpm typecheck
pnpm lint
pnpm generate:docs

维护者可以运行 pnpm import:sitemap <url>，检查网站页面与 CLI 命令的对应关系。

该仓库是一个 pnpm monorepo：

• @textavia/core — 纯工具契约和注册表。
• @textavia/schemas — Zod 模式和 JSON schema 导出。
• @textavia/node-adapters — 文件系统、流、加密和工作线程辅助工具。
• @textavia/plugin-standard — 打包的默认工具。
• textavia — CLI 包，包含打包的 skills/。
• @textavia/plugin-formatters — 可选的格式化工具插件。
• @textavia/plugin-media — 可选的媒体/PDF/OCR 插件。
• @textavia/mcp — MCP 服务。

许可证

MIT