Pare

🚀 Pare

Pare為AI智能體提供可靠、結構化的命令行界面（CLI）輸出，避免再解析脆弱的終端文本。

🚀 快速開始

快速設置：

# 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的映射

✨ 主要特性

• 提供 MCP 服務器，包裝常見開發工具（git、npm、docker、測試運行器等），返回乾淨、經過模式驗證的JSON，而非原始終端文本。
• 消除因解析CLI輸出而產生的錯誤，無論平臺、工具版本或語言環境如何，都能返回具有一致字段名的模式驗證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%。

📚 詳細文檔

可用服務器（28個包，240個工具）

僅安裝與你的技術棧相關的服務器，大多數項目只需要2 - 4個。完整的目錄涵蓋了廣泛的生態系統，因此Pare可以在任何環境中使用。

工具模式 — 每個工具的詳細響應示例和字段描述。 另請參閱 工具響應示例 以獲取快速JSON示例。

配置

工具選擇

默認情況下，每個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"
      }
    }
  }
}

故障排除

🔧 技術細節

每個Pare工具返回兩個輸出：

• content — 供MCP客戶端顯示的人類可讀文本。
• structuredContent — 類型化、經過模式驗證的JSON，可供智能體直接處理。

這利用了MCP的 structuredContent 和 outputSchema 特性，提供類型安全、經過驗證的數據，智能體無需自定義解析即可依賴這些數據。

📄 許可證

MIT

貢獻

每個服務器都是一個獨立的包。完整指南請參閱 CONTRIBUTING.md。