Textavia Mcp

Textavia CLI

テキスト、データ、エンコーディング、フォーマット、開発者向けユーティリティを扱う、高速でローカルファーストなコマンドラインツールキットです。共有ツールレジストリを基盤としており、CLI、ドキュメント、MCP サーバー、エージェント用マニフェストの内容が常に一致します。

概要

Textavia は、小規模で組み合わせ可能な開発者向けツールを、単一の CLI で利用できるようにしたものです。 ブラウザーのタブを開くほどではないものの、使い捨てのシェルスニペットを書き直すのは面倒な、頻繁に行う作業を対象としています。JSON の整形、Base64 のデコード、貼り付けたテキストのクリーニング、CSV の変換、ファイルのハッシュ計算、正規表現のテスト、UUID の生成、プライベートな文字列の除去、エージェントが読み取りやすい JSON 出力の作成などが可能です。

npm パッケージは、エージェント向けの配布アセットでもあります。textavia をインストールすると、txv / textavia バイナリに加え、Pi、Hermes、OpenClaw などのスキルベースのエージェントシステム向けの SKILL.md 指示ファイルが同梱されます。

Textavia CLI を選ぶ理由

• ローカルファーストでプライベート。 標準のコマンドは入力をローカルで処理します。アカウント、API キー、テレメトリーは不要で、気付かないうちにネットワークへアクセスすることもありません。
• 組み合わせ可能。 Unix に適した stdin/stdout、安定した終了コード、予期しないファイル解釈がありません。
• エージェント対応。 決定的な 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

スクリプトやエージェントでは、正規のツール 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 エンコーディング、16 進数、バイナリ、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 をそのままスラッグ化します。ディスクから読み込む場合は --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 を参照してください。

エージェントスキル

textavia npm パッケージには、skills/ 配下の SKILL.md フォルダーが含まれており、GitHub で見つけやすいように、リポジトリのルートにある skills/ ディレクトリにも同じものが配置されています。 Pi は npm から直接読み込めます。

pi install npm:textavia

skills.sh 互換のエージェントは、GitHub からリポジトリのスキルを直接インストールできます。

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

収録されているスキル、実行時の動作、安全ルールについては、docs/agent-skills.md をご覧ください。

オンラインツール

ブラウザー UI の方がよいですか？

• 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 には、暗号学的に安全な乱数を使用します。
• ファイルへの書き込みはアトミックに行われます（temp + rename）。--backup を指定すると、最初に .bak ファイルを作成します。
• JWT のデコードは署名検証を意味するものではありません。正規表現はタイムアウト付きの分離されたワーカーで実行されます。

開発

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

メンテナーは pnpm import:sitemap <url> を実行して、ウェブサイトのページが CLI コマンドにどのように対応するかを確認できます。

このリポジトリは pnpm モノレポです。

• @textavia/core — ツールの契約とレジストリのみを提供します。
• @textavia/schemas — Zod スキーマと JSON Schema のエクスポートを提供します。
• @textavia/node-adapters — ファイルシステム、ストリーム、暗号化、ワーカーのヘルパーを提供します。
• @textavia/plugin-standard — デフォルトのツールを同梱しています。
• textavia — skills/ を同梱する CLI パッケージです。
• @textavia/plugin-formatters — オプションのフォーマッタープラグインです。
• @textavia/plugin-media — オプションのメディア／PDF／OCR プラグインです。
• @textavia/mcp — MCP サーバーです。

ライセンス

MIT