Liefert strukturiertes, schema-validiertes JSON für Python CLI-Tools wie ruff, mypy, pip, uv, black und pytest.
Auch bekannt als Dave-London/Pare, @paretools/python
- Stars
- 141
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 0.8.1
- Letzter Commit
- 10. Nov. 2026
- Lizenz
- MIT
Was ist Pare Python MCP?
Pare Python ist ein MCP server. Liefert strukturiertes, schema-validiertes JSON für Python CLI-Tools wie ruff, mypy, pip, uv, black und pytest.
Zusammenfassung generiert aus dem README des Projekts
Über Pare Python MCP server
pare-python ermöglicht es AI-Agenten, strukturiertes, schema-validiertes JSON für Python-Development-Tools bereitzustellen. Anstatt einen Agenten dazu zu zwingen, fragilen Terminal-Text mit ANSI-Escape-Codes oder plattformspezifischer Formatierung zu parsen, konvertiert dieser Server den Output von CLI-Tools in typisierte Daten. Das erlaubt es Entwicklern, AI-Clients wie Claude Desktop, Cursor oder Windsurf zu nutzen, um mit deutlich höherer Zuverlässigkeit mit ihrer Python-Umgebung zu interagieren.
Der Server wrapped gängige Befehle wie ruff, mypy, pip, uv, black und pytest. Durch die Rückgabe von structuredContent anstelle von rohen Strings wird der Token-Verbrauch signifikant gesenkt – oft um über 60 % bei ausführlichen Befehlen wie pip install. Nutzer können über Umgebungsvariablen wie PARE_PYTHON_TOOLS konfigurieren, welche spezifischen Tools ihrem Agent zur Verfügung gestellt werden, um ein minimales und fokussiertes Toolset beizubehalten. Dieses Setup ist ideal für Entwickler, die möchten, dass ihre AI-Coding-Assistenten Linting, Type Checking und Dependency Management durchführen, ohne das Risiko von fehlerhaften Regex-Patterns oder Parsing-Fehlern.
Was du damit machen kannst
- 1Automatisierte Dependency-VerwaltungEin AI-Agent kann Python-Packages mit pip installieren und erhält eine strukturierte Liste der installierten Items anstatt einer Textwüste.
- 2Zuverlässiges Code-Linting und FormattingEntwickler können einen Agenten beauftragen, ruff oder black auszuführen, um die Code-Qualität durch typisiertes JSON-Feedback sicherzustellen.
- 3Automatisierte Testausführung und -analyseEin Agent kann pytest ausführen und die Testergebnisse durch schema-validierte Daten sofort verstehen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Pare Python MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenPare Python MCP in Claude Code installieren
$ claude mcp add pare-python -- npx -y @paretools/pythonPare Python MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"pare-python": {
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}Pare Python MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"pare-python": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}Pare Python MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"pare-python","type":"stdio","command":"npx","args":["-y","@paretools/python"]}'Pare Python MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"pare-python": {
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}Pare Python MCP in Codex installieren
$ codex mcp add pare-python -- npx -y @paretools/pythonPare Python MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.pare-python] command = "npx" args = ["-y", "@paretools/python"]
Pare Python MCP in Gemini CLI installieren
$ gemini mcp add -s user pare-python npx -- -y @paretools/pythonPare Python MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"pare-python": {
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}Konfiguration
PARE_GIT_TOOLSPARE_NPM_TOOLSPARE_TOOLS
| Name | Beschreibung | Typ |
|---|---|---|
| PARE_GIT_TOOLS | — | |
| PARE_NPM_TOOLS | — | |
| PARE_TOOLS | — |
Automatisierte Checks
Geluften am 12. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSNicht geprüft
- Destruktive Tools sind markiertNicht geprüft
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehenReliable, 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 Fragen
Wie füge ich Pare Python MCP zu Claude Code hinzu?
Führe claude mcp add pare-python -- npx -y @paretools/python in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Pare Python MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Was liefert Pare Python anstelle von rohem Terminal-Output?
Es liefert sauberes, schema-validiertes JSON mit konsistenten Feldnamen für Python-Tools wie ruff, mypy, pip, uv, black und pytest.
Welche Python-Tools werden von Pare wrapped?
Der Pare Python server wrapped unter anderem pip als Sprach- und Package-Tool, und pytest ist in seinem Test-Tooling enthalten.
Bieten Pare-Tools sowohl menschenlesbare als auch typisierte Ausgaben?
Ja, jedes Tool liefert menschenlesbaren Text in content und typisiertes, schema-validiertes JSON in structuredContent.
Kann ich einschränken, welche Tools ein Pare server registriert?
Ja, nutze Umgebungsvariablen pro Server wie PARE_PYTHON_TOOLS, um nur ausgewählte Tools zu registrieren.
Reduziert Pare den Token-Verbrauch bei ausführlichen Befehlen?
Ja, strukturierte Ausgaben sind kleiner als roher Terminal-Text, was bei ausführlichen Install- und Build-Outputs zu massiven Reduktionen führt.