ruff、mypy、pip、uv、black、pytestなどのPython CLIツール向けに、スキーマ検証済みの構造化されたJSONを返します。
別名 Dave-London/Pare, @paretools/python
- スター
- 141
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.8.1
- 最終コミット
- 2026年11月10日
- ライセンス
- MIT
Pare Python MCPとは
ruff、mypy、pip、uv、black、pytestなどのPython CLIツール向けに、スキーマ検証済みの構造化されたJSONを返します。
プロジェクトのREADMEから生成された概要
Pare Python MCP server について
pare-pythonは、AIエージェントがPython開発ツールに対して、スキーマ検証済みの構造化されたJSONを利用できるようにします。エージェントに、ANSIエスケープコードやプラットフォーム固有のフォーマットを含む不安定なターミナルテキストの解析を強いる代わりに、このサーバーはCLIツールの出力を型定義されたデータに変換します。これにより、開発者はClaude Desktop、Cursor、WindsurfなどのAIクライアントを使用して、より高い信頼性でPython環境とやり取りできるようになります。
このサーバーは、ruff、mypy、pip、uv、black、pytestなどの一般的なコマンドをラップしています。生の文字列の代わりにstructuredContentを返すことで、pip installのような詳細な出力を行うコマンドでは、トークン使用量を60%以上削減できることもあります。ユーザーはPARE_PYTHON_TOOLSなどの環境変数を使用して、エージェントに公開する特定のツールを構成し、最小限で集中したツールセットを維持できます。この構成は、正規表現のパターン崩れや解析エラーのリスクなしに、AIコーディングアシスタントにリンティング、型チェック、依存関係管理を行わせたい開発者に最適です。
できること
- 1依存関係管理の自動化AIエージェントはpipを使用してPythonパッケージをインストールし、大量のテキストの代わりに、インストールされたアイテムの構造化されたリストを受け取ることができます。
- 2信頼性の高いコードリンティングとフォーマット開発者はエージェントにruffやblackの実行を指示し、型定義されたJSONフィードバックを通じてコード品質を確保できます。
- 3テスト実行と分析の自動化エージェントはpytestを実行し、スキーマ検証済みのデータを通じてテスト結果を即座に理解できます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Pare Python MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにPare Python MCPをインストール
$ claude mcp add pare-python -- npx -y @paretools/pythonCursorにPare Python MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"pare-python": {
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}VS CodeにPare Python MCPをインストール
.vscode/mcp.json
{
"servers": {
"pare-python": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}VS Code CLIにPare Python MCPをインストール
$ code --add-mcp '{"name":"pare-python","type":"stdio","command":"npx","args":["-y","@paretools/python"]}'Claude DesktopにPare Python MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"pare-python": {
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}CodexにPare Python MCPをインストール
$ codex mcp add pare-python -- npx -y @paretools/pythonCodex config.tomlにPare Python MCPをインストール
~/.codex/config.toml
[mcp_servers.pare-python] command = "npx" args = ["-y", "@paretools/python"]
Gemini CLIにPare Python MCPをインストール
$ gemini mcp add -s user pare-python npx -- -y @paretools/pythonGemini settings.jsonにPare Python MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"pare-python": {
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}設定
PARE_GIT_TOOLSPARE_NPM_TOOLSPARE_TOOLS
| 名前 | 説明 | 種類 |
|---|---|---|
| PARE_GIT_TOOLS | — | |
| PARE_NPM_TOOLS | — | |
| PARE_TOOLS | — |
自動チェック
実行日 2026年11月12日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている未チェック
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見るReliable, structured CLI output for AI agents — no more parsing fragile terminal text.
Pare provides MCP servers that wrap common developer tools (git, npm, docker, test runners, etc.) and return clean, schema-validated JSON instead of raw terminal text. Agents get typed data they can act on directly, without brittle string parsing.
The Problem
Parsing CLI output is fragile. Raw terminal text includes ANSI escape codes, decorative headers, progress bars, locale-specific formatting, and platform differences that break agent workflows in subtle ways. An agent that works fine with git status on macOS may fail on Windows because the output format changed. A test runner's summary line might shift between versions, silently breaking a regex.
Pare eliminates this entire class of errors by returning schema-validated JSON with consistent field names, regardless of platform, tool version, or locale. As a bonus, structured output is significantly smaller — agents use fewer tokens per tool call:
| Tool Command | Raw Tokens | Pare Tokens | Reduction |
|---|---|---|---|
docker build (multi-stage, 11 steps) |
373 | 20 | 95% |
git log --stat (5 commits, verbose) |
4,992 | 382 | 92% |
npm install (487 packages, warnings) |
241 | 41 | 83% |
vitest run (28 tests, all pass) |
196 | 39 | 80% |
cargo build (2 errors, help text) |
436 | 138 | 68% |
pip install (9 packages, progress bars) |
288 | 101 | 65% |
cargo test (12 tests, 2 failures) |
351 | 190 | 46% |
npm audit (4 vulnerabilities) |
287 | 185 | 36% |
Token estimates use ~4 chars/token. The biggest savings appear on verbose commands (builds, installs, tests). For simpler tools like
eslintortsc, the main advantage is reliable structured data — agents can use typed JSON directly rather than parsing strings.
How It Works
Each Pare tool returns two outputs:
content— human-readable text, for MCP clients that display itstructuredContent— typed, schema-validated JSON, ready for agents to process
This uses MCP's structuredContent and outputSchema features to provide type-safe, validated data that agents can rely on without custom parsing.
Example: git status
Raw git output (~118 tokens):
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 structured output (~59 tokens):
{
"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% fewer tokens. Zero information lost. Fully typed. Savings scale with output verbosity — test runners and build logs see 80–92% reduction.
Available Servers (28 packages, 240 tools)
Install only the servers relevant to your stack — most projects need just 2–4. The full catalog covers a wide range of ecosystems so Pare works wherever you do.
| Category | Servers | Tools | Wraps |
|---|---|---|---|
| Version Control | git, github | 55 | git, gh |
| Languages & Packages | npm, python, cargo, go, deno, bun, nix, dotnet, ruby, swift, jvm | 101 | npm, pip, cargo, go, deno, bun, nix, dotnet, gem, swift, gradle, maven |
| Build, Lint & Test | build, lint, test, cmake, bazel | 23 | tsc, esbuild, vite, webpack, eslint, prettier, biome, vitest, pytest, jest |
| Infrastructure | docker, k8s, infra, security, remote | 40 | docker, kubectl, helm, terraform, ansible, trivy, ssh |
| Utilities | search, http, make, process, db | 21 | ripgrep, fd, curl, make, just, psql, mysql, redis, mongosh |
Tool Schemas — detailed response examples and field descriptions for every tool. See also Tool Response Examples for quick JSON samples.
Quick Setup
# 1. Configure MCP servers (non-interactive)
npx @paretools/init --client claude-code --preset web
# 2. Add agent rules to your project
# (append to existing CLAUDE.md, or copy if new)
cat node_modules/@paretools/init/rules/CLAUDE.md >> CLAUDE.md
# 3. Restart your client session
# 4. Validate
npx @paretools/init doctor
Available presets: web, python, rust, go, jvm, dotnet, ruby, swift, mobile, devops, full
Setup Guides by Client
| Claude Code | Claude Desktop | Cursor |
| VS Code / Copilot | Windsurf | Cline / Roo Code |
| OpenAI Codex | Gemini CLI | Zed |
| Continue.dev |
Full Quickstart Guide — presets, ecosystem mapping, validation
Manual Configuration — config paths and formats for all clients
Agent Integration Guide — rule files, hooks, CLI-to-MCP mapping
Configuration
Tool Selection
By default, every Pare server registers all of its tools. If a server exposes tools you don't need — or you want to limit which tools are available to an agent — you can filter them with environment variables.
Per-server filter — restrict a single server's tools:
# Only register status and log in the git server
PARE_GIT_TOOLS=status,log npx @paretools/git
Universal filter — restrict tools across all servers:
# Only register these specific tools across any server
PARE_TOOLS=git:status,git:log,npm:install npx @paretools/git
Disable all tools — set the env var to an empty string:
PARE_GIT_TOOLS= npx @paretools/git # no tools registered
| Env Var | Scope | Format | Example |
|---|---|---|---|
PARE_TOOLS |
All servers | server:tool,... |
git:status,npm:install |
PARE_{SERVER}_TOOLS |
One server | tool,... |
status,log,diff |
Rules:
- No env var = all tools enabled (default)
PARE_TOOLS(universal) takes precedence over per-server vars- Server names use uppercase with hyphens replaced by underscores (e.g.,
PARE_MY_SERVER_TOOLS) - Whitespace around commas is ignored
Common patterns:
# Read-only git (no push, commit, add, checkout)
PARE_GIT_TOOLS=status,log,diff,branch,show
# Minimal npm
PARE_NPM_TOOLS=install,test,run
# Only specific tools across all servers
PARE_TOOLS=git:status,git:diff,npm:install,test:run
In JSON MCP config, set via the env key:
{
"mcpServers": {
"pare-git": {
"command": "npx",
"args": ["-y", "@paretools/git"],
"env": {
"PARE_GIT_TOOLS": "status,log,diff,show"
}
}
}
}
Troubleshooting
| Issue | Solution |
|---|---|
npx not found / ENOENT on Windows |
Use cmd /c npx wrapper (see your client's setup guide) |
| Slow first start | Run npx -y @paretools/git once to cache, or install globally: npm i -g @paretools/git |
| Node.js version error | Pare requires Node.js >= 20 |
| NVM/fnm PATH issues | Use absolute path to npx: e.g., ~/.nvm/versions/node/v22/bin/npx |
| MCP connection timeout | Set MCP_TIMEOUT=30000 for Claude Code, or increase initTimeout in client config |
| Too many tools filling context | Use tool selection env vars to limit tools, or only install the servers you need |
Contributing
Each server is a self-contained package. See CONTRIBUTING.md for the full guide.
License
Pare Python MCPのよくある質問
Pare Python MCPをClaude Codeに追加するには
ターミナルでclaude mcp add pare-python -- npx -y @paretools/pythonを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Pare Python MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Pare Pythonは、生のターミナル出力の代わりに何を返しますか?
ruff、mypy、pip、uv、black、pytestなどのPythonツールに対して、一貫したフィールド名を持つ、クリーンでスキーマ検証済みのJSONを返します。
PareはどのPythonツールをラップしていますか?
PareのPythonサーバーは、言語およびパッケージツールとしてpipをラップしており、テストツールとしてpytestをカバーしています。
Pareのツールは、人間が読める形式と型定義された形式の両方の出力を提供しますか?
はい。各ツールは、contentに人間が読めるテキストを、structuredContentに型定義されたスキーマ検証済みのJSONを返します。
Pareサーバーが登録するツールを制限することはできますか?
はい。PARE_PYTHON_TOOLSなどのサーバーごとの環境変数を使用して、選択したツールのみを登録できます。
Pareは、詳細な出力(verbose)を伴うコマンドのトークン使用量を削減できますか?
はい。構造化された出力は生のターミナルテキストよりもサイズが小さく、pip installのような詳細なインストールやビルドの出力では大幅に削減されます。