Fournit du JSON structuré et validé par schéma pour les outils CLI Python tels que ruff, mypy, pip, uv, black et pytest.
Aussi connu sous Dave-London/Pare, @paretools/python
- Étoiles
- 141
- Outils
- 11
- Téléchargements, 30 jours
- —
- Dernière version
- 0.8.1
- Dernier commit
- 10 nov. 2026
- Licence
- MIT
Qu'est-ce que Pare Python MCP ?
Fournit du JSON structuré et validé par schéma pour les outils CLI Python tels que ruff, mypy, pip, uv, black et pytest. Il expose 11 outils, comme pip-install, pip-list, pip-show.
Résumé généré à partir du README du projet
À propos du MCP server Pare Python
Pare-python permet aux agents IA d'obtenir du JSON structuré et validé par schéma pour les outils de développement Python. Au lieu de contraindre un agent à analyser du texte de terminal fragile contenant des codes d'échappement ANSI ou un formatage spécifique à la plateforme, ce serveur convertit la sortie des outils CLI en données typées. Cela permet aux développeurs d'utiliser des clients IA comme Claude Desktop, Cursor ou Windsurf pour interagir avec leur environnement Python avec une fiabilité bien plus élevée.
Le serveur encapsule les commandes courantes telles que ruff, mypy, pip, uv, black et pytest. En renvoyant du structuredContent au lieu de chaînes de caractères brutes, il réduit considérablement la consommation de tokens, souvent de plus de 60 % pour des commandes verbeuses comme pip install. Les utilisateurs peuvent configurer les outils spécifiques exposés à leur agent en utilisant des variables d'environnement comme PARE_PYTHON_TOOLS afin de maintenir un ensemble d'outils minimal et ciblé. Cette configuration est idéale pour les développeurs qui souhaitent que leurs assistants de codage IA effectuent du linting, de la vérification de types et de la gestion de dépendances sans risque de patterns regex cassés ou d'erreurs d'analyse.
Ce que vous pouvez faire avec
- 1Gestion automatisée des dépendancesUn agent IA peut installer des paquets Python via pip et recevoir une liste structurée des éléments installés plutôt qu'un bloc de texte compact.
- 2Linting et formatage de code fiablesLes développeurs peuvent charger un agent de l'exécution de ruff ou black pour garantir la qualité du code grâce à un retour JSON typé.
- 3Exécution et analyse automatisées de testsUn agent peut exécuter pytest et comprendre immédiatement les résultats des tests grâce à des données validées par schéma.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Pare Python MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Pare Python MCP dans Claude Code
$ claude mcp add pare-python -- npx -y @paretools/pythonInstaller Pare Python MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"pare-python": {
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}Installer Pare Python MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"pare-python": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}Installer Pare Python MCP dans VS Code CLI
$ code --add-mcp '{"name":"pare-python","type":"stdio","command":"npx","args":["-y","@paretools/python"]}'Installer Pare Python MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"pare-python": {
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}Installer Pare Python MCP dans Codex
$ codex mcp add pare-python -- npx -y @paretools/pythonInstaller Pare Python MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.pare-python] command = "npx" args = ["-y", "@paretools/python"]
Installer Pare Python MCP dans Gemini CLI
$ gemini mcp add -s user pare-python npx -- -y @paretools/pythonInstaller Pare Python MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"pare-python": {
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}Démarré par HostedMCP le 16 nov. 2026
Nous avons lancé cette commande pour @paretools/python 0.8.1 dans un conteneur isolé, sans réseau ni clé. Il a répondu et listé 11 outils.
Outils MCP Pare Python 11
Lu sur le serveur avec tools/listpip-installRuns pip install and returns a structured summary of installed packages. Use instead of running `pip install` in the terminal. WARNING: Installing packages may execute arbitrary setup.py code. Only install trusted packages. Use dryRun to preview what would be installed before committing.
pip-listRuns pip list and returns a structured list of installed packages. Use instead of running `pip list` in the terminal.
pip-showRuns pip show and returns structured package metadata (name, version, summary, dependencies). Use instead of running `pip show` in the terminal.
mypyRuns mypy and returns structured type-check diagnostics (file, line, severity, message, code). Use instead of running `mypy` in the terminal.
ruff-checkRuns ruff check and returns structured lint diagnostics (file, line, code, message). Use instead of running `ruff check` in the terminal.
ruff-formatRuns ruff format and returns structured results (files changed, file list). Use instead of running `ruff format` in the terminal.
pip-auditRuns pip-audit and returns a structured vulnerability report. Use instead of running `pip-audit` in the terminal.
pytestRuns pytest and returns structured test results (passed, failed, errors, skipped, failures). Use instead of running `pytest` in the terminal.
uv-installRuns uv pip install and returns a structured summary of installed packages. Use instead of running `uv pip install` in the terminal. WARNING: Installing packages may execute arbitrary setup.py code during build. Only install trusted packages. Use dryRun to preview what would be installed before committing.
uv-runRuns a command in a uv-managed environment and returns structured output. Use instead of running `uv run` in the terminal.
blackRuns Black code formatter and returns structured results (files changed, unchanged, would reformat). Use instead of running `black` in the terminal.
| pip-install | Runs pip install and returns a structured summary of installed packages. Use instead of running `pip install` in the terminal. WARNING: Installing packages may execute arbitrary setup.py code. Only install trusted packages. Use dryRun to preview what would be installed before committing. | |
| pip-list | Runs pip list and returns a structured list of installed packages. Use instead of running `pip list` in the terminal. | |
| pip-show | Runs pip show and returns structured package metadata (name, version, summary, dependencies). Use instead of running `pip show` in the terminal. | |
| mypy | Runs mypy and returns structured type-check diagnostics (file, line, severity, message, code). Use instead of running `mypy` in the terminal. | |
| ruff-check | Runs ruff check and returns structured lint diagnostics (file, line, code, message). Use instead of running `ruff check` in the terminal. | |
| ruff-format | Runs ruff format and returns structured results (files changed, file list). Use instead of running `ruff format` in the terminal. | |
| pip-audit | Runs pip-audit and returns a structured vulnerability report. Use instead of running `pip-audit` in the terminal. | |
| pytest | Runs pytest and returns structured test results (passed, failed, errors, skipped, failures). Use instead of running `pytest` in the terminal. | |
| uv-install | Runs uv pip install and returns a structured summary of installed packages. Use instead of running `uv pip install` in the terminal. WARNING: Installing packages may execute arbitrary setup.py code during build. Only install trusted packages. Use dryRun to preview what would be installed before committing. | |
| uv-run | Runs a command in a uv-managed environment and returns structured output. Use instead of running `uv run` in the terminal. | |
| black | Runs Black code formatter and returns structured results (files changed, unchanged, would reformat). Use instead of running `black` in the terminal. |
Configuration
PARE_GIT_TOOLSPARE_NPM_TOOLSPARE_TOOLS
| Nom | Description | Type |
|---|---|---|
| PARE_GIT_TOOLS | — | |
| PARE_NPM_TOOLS | — | |
| PARE_TOOLS | — |
Vérifications automatisées
Exécuté le 12 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleRéussi
- Licence open source (OSI)Réussi
- Commit ou version publiée au cours de l'année écouléeRéussi
- Nom du package non proche d'un package populaireRéussi
- L'endpoint distant utilise HTTPSNon vérifié
- Les outils destructifs sont étiquetésNon vérifié
- Aucune instruction cachée destinée au modèleRéussi
- Aucun avis critique dans le package ou ses dépendancesRéussi
README
Voir sur GitHubReliable, 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
Questions sur Pare Python MCP
Comment ajouter Pare Python MCP à Claude Code ?
Exécutez claude mcp add pare-python -- npx -y @paretools/python dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Pare Python MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils Pare Python MCP fournit-il ?
Il expose 11 outils, dont pip-install, pip-list, pip-show, mypy, ruff-check.
Que renvoie Pare Python à la place de la sortie brute du terminal ?
Il renvoie du JSON propre et validé par schéma avec des noms de champs cohérents pour les outils Python tels que ruff, mypy, pip, uv, black et pytest.
Quels outils Python Pare prend-il en charge ?
Le serveur Python de Pare englobe pip parmi les outils de langage et de gestion de paquets, et pytest est inclus dans sa partie test.
Les outils Pare fournissent-ils à la fois une sortie lisible par l'homme et une sortie typée ?
Oui, chaque outil renvoie du texte lisible par l'homme dans le champ content et du JSON typé et validé par schéma dans structuredContent.
Puis-je limiter les outils qu'un serveur Pare enregistre ?
Oui, utilisez des variables d'environnement par serveur comme PARE_PYTHON_TOOLS pour n'enregistrer que les outils sélectionnés.
Pare réduit-il la consommation de tokens pour les commandes verbeuses ?
Oui, la sortie structurée est plus légère que le texte brut du terminal, avec des réductions importantes sur les sorties verbeuses d'installation et de build.