Pare

🚀 Pare

信頼性の高い、構造化されたCLI出力をAIエージェントに提供 — 脆弱なターミナルテキストの解析を不要にします。

Pareは、一般的な開発者ツール（git、npm、docker、テストランナーなど）をラップするMCPサーバーを提供し、生のターミナルテキストではなく、クリーンでスキーマ検証済みのJSONを返します。エージェントは、脆弱な文字列解析を行うことなく、直接操作できる型付きデータを取得できます。

🚀 クイックスタート

# 1. MCPサーバーを構成する（非対話的）
npx @paretools/init --client claude-code --preset web

# 2. エージェントルールをプロジェクトに追加する
#    （既存のCLAUDE.mdに追加するか、新規の場合はコピーする）
cat node_modules/@paretools/init/rules/CLAUDE.md >> CLAUDE.md

# 3. クライアントセッションを再起動する

# 4. 検証する
npx @paretools/doctor

利用可能なプリセット: web, python, rust, go, jvm, dotnet, ruby, swift, mobile, devops, full

クライアント別のセットアップガイド

完全なクイックスタートガイド — プリセット、エコシステムマッピング、検証

手動構成ガイド — すべてのクライアントの構成パスと形式

エージェント統合ガイド — ルールファイル、フック、CLIからMCPへのマッピング

✨ 主な機能

Pareは、以下のような機能を提供します。

• 一般的な開発者ツールをラップし、スキーマ検証済みのJSONを返すことで、AIエージェントが脆弱な文字列解析を行う必要をなくします。
• プラットフォーム、ツールのバージョン、ロケールに関係なく、一貫したフィールド名を持つJSONを返すことで、解析エラーを排除します。
• 構造化された出力は、生のターミナルテキストよりも大幅に小さく、エージェントがツール呼び出しごとに使用するトークン数を削減します。

📦 インストール

必要なサーバーのみをインストールします。ほとんどのプロジェクトでは2～4つのサーバーが必要です。

ツールスキーマ — すべてのツールの詳細なレスポンス例とフィールドの説明

ツールレスポンス例 — 迅速なJSONサンプル

💻 使用例

基本的な使用法

例: git status

生のgit出力（約118トークン）:

On branch main
Your branch is ahead of 'origin/main' by 2 commits.
  (use "git push" to publish your local commits)

Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        modified:   src/index.ts
        new file:   src/utils.ts

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   README.md

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        temp.log

Pareの構造化された出力（約59トークン）:

{
  "branch": "main",
  "upstream": "origin/main",
  "ahead": 2,
  "staged": [
    { "file": "src/index.ts", "status": "modified" },
    { "file": "src/utils.ts", "status": "added" }
  ],
  "modified": ["README.md"],
  "deleted": [],
  "untracked": ["temp.log"],
  "conflicts": [],
  "clean": false
}

トークン数が50%減少し、情報が一切失われません。完全に型付けされています。出力の詳細度に応じて節約効果が増加し、テストランナーやビルドログでは80～92%の削減が見られます。

📚 ドキュメント

設定

ツール選択

デフォルトでは、すべてのPareサーバーがそのすべてのツールを登録します。サーバーが不要なツールを公開している場合、またはエージェントが使用できるツールを制限したい場合は、環境変数を使用してフィルタリングできます。

サーバーごとのフィルタ — 単一のサーバーのツールを制限します。

# gitサーバーでstatusとlogのみを登録する
PARE_GIT_TOOLS=status,log npx @paretools/git

ユニバーサルフィルタ — すべてのサーバーのツールを制限します。

# 任意のサーバーでこれらの特定のツールのみを登録する
PARE_TOOLS=git:status,git:log,npm:install npx @paretools/git

すべてのツールを無効にする — 環境変数を空文字列に設定します。

PARE_GIT_TOOLS= npx @paretools/git   # ツールが登録されません

ルール:

• 環境変数がない場合 = すべてのツールが有効（デフォルト）
• PARE_TOOLS（ユニバーサル）は、サーバーごとの変数よりも優先されます
• サーバー名は大文字で、ハイフンはアンダースコアに置き換えられます（例: PARE_MY_SERVER_TOOLS）
• コンマの周りの空白は無視されます

一般的なパターン:

# 読み取り専用のgit（push、commit、add、checkoutなし）
PARE_GIT_TOOLS=status,log,diff,branch,show

# 最小限のnpm
PARE_NPM_TOOLS=install,test,run

# すべてのサーバーで特定のツールのみ
PARE_TOOLS=git:status,git:diff,npm:install,test:run

JSONのMCP構成では、envキーを使用して設定します。

{
  "mcpServers": {
    "pare-git": {
      "command": "npx",
      "args": ["-y", "@paretools/git"],
      "env": {
        "PARE_GIT_TOOLS": "status,log,diff,show"
      }
    }
  }
}

トラブルシューティング

🔧 技術詳細

問題

CLI出力の解析は脆弱です。生のターミナルテキストには、ANSIエスケープコード、装飾的なヘッダー、プログレスバー、ロケール固有の書式設定、およびプラットフォームの違いが含まれており、エージェントのワークフローを微妙な方法で破壊します。macOSでgit statusが正常に動作するエージェントは、出力形式が変更されたためにWindowsで失敗する可能性があります。テストランナーの要約行がバージョン間で変更されると、正規表現が静かに破損することがあります。

Pareは、プラットフォーム、ツールのバージョン、またはロケールに関係なく、一貫したフィールド名を持つスキーマ検証済みのJSONを返すことで、この種のエラーを完全に排除します。さらに、構造化された出力は大幅に小さく、エージェントはツール呼び出しごとにより少ないトークンを使用します。

トークンの推定には、約4文字/トークンを使用しています。最も大きな節約は、詳細なコマンド（ビルド、インストール、テスト）で見られます。eslintやtscなどの単純なツールの場合、主な利点は信頼性の高い構造化データです。エージェントは、文字列解析ではなく、型付きのJSONを直接使用できます。

仕組み

各Pareツールは2つの出力を返します。

• content — MCPクライアントが表示するための人間が読めるテキスト
• structuredContent — エージェントが処理する準備ができた型付きのスキーマ検証済みのJSON

これは、MCPのstructuredContentとoutputSchema機能を使用して、エージェントがカスタム解析なしで信頼できる型安全で検証済みのデータを提供します。

📄 ライセンス

MIT

貢献方法

各サーバーは独立したパッケージです。詳細なガイドについては、CONTRIBUTING.mdを参照してください。