Devuelve JSON estructurado y validado mediante esquemas para herramientas de CLI de Python como ruff, mypy, pip, uv, black y pytest.
También conocido como Dave-London/Pare, @paretools/python
- Stars
- 141
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.8.1
- Último commit
- 10 nov 2026
- Licencia
- MIT
¿Qué es Pare Python MCP?
Devuelve JSON estructurado y validado mediante esquemas para herramientas de CLI de Python como ruff, mypy, pip, uv, black y pytest.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Pare Python
Lo que pare-python permite a los agentes de IA es obtener JSON estructurado y validado mediante esquemas para herramientas de desarrollo en Python. En lugar de obligar a un agente a analizar texto frágil de la terminal que contiene códigos de escape ANSI o formatos específicos de la plataforma, este servidor convierte la salida de las herramientas CLI en datos tipados. Esto permite a los desarrolladores usar clientes de IA como Claude Desktop, Cursor o Windsurf para interactuar con su entorno de Python con una fiabilidad mucho mayor.
El servidor envuelve comandos comunes como ruff, mypy, pip, uv, black y pytest. Al devolver structuredContent en lugar de cadenas de texto brutas, reduce significativamente el uso de tokens, a menudo en más de un 60% en comandos verbosos como pip install. Los usuarios pueden configurar qué herramientas específicas se exponen a su agente mediante variables de entorno como PARE_PYTHON_TOOLS para mantener un conjunto de herramientas mínimo y enfocado. Esta configuración es ideal para desarrolladores que quieren que sus asistentes de codificación con IA realicen linting, comprobación de tipos y gestión de dependencias sin el riesgo de patrones regex rotos o errores de análisis.
Qué puedes hacer con él
- 1Gestión automatizada de dependenciasUn agente de IA puede instalar paquetes de Python usando pip y recibir una lista estructurada de los elementos instalados en lugar de un bloque de texto ininterrumpido.
- 2Linting y formateo de código fiableLos desarrolladores pueden asignar a un agente la tarea de ejecutar ruff o black para asegurar la calidad del código mediante feedback en JSON tipado.
- 3Ejecución y análisis automatizado de pruebasUn agente puede ejecutar pytest y comprender inmediatamente los resultados de las pruebas a través de datos validados mediante esquemas.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Pare Python MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Pare Python MCP en Claude Code
$ claude mcp add pare-python -- npx -y @paretools/pythonInstalar Pare Python MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"pare-python": {
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}Instalar Pare Python MCP en VS Code
.vscode/mcp.json
{
"servers": {
"pare-python": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}Instalar Pare Python MCP en VS Code CLI
$ code --add-mcp '{"name":"pare-python","type":"stdio","command":"npx","args":["-y","@paretools/python"]}'Instalar Pare Python MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"pare-python": {
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}Instalar Pare Python MCP en Codex
$ codex mcp add pare-python -- npx -y @paretools/pythonInstalar Pare Python MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.pare-python] command = "npx" args = ["-y", "@paretools/python"]
Instalar Pare Python MCP en Gemini CLI
$ gemini mcp add -s user pare-python npx -- -y @paretools/pythonInstalar Pare Python MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"pare-python": {
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}Configuración
PARE_GIT_TOOLSPARE_NPM_TOOLSPARE_TOOLS
| Nombre | Descripción | Tipo |
|---|---|---|
| PARE_GIT_TOOLS | — | |
| PARE_NPM_TOOLS | — | |
| PARE_TOOLS | — |
Verificaciones automáticas
Ejecutado 12 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSNo verificado
- Las herramientas destructivas están etiquetadasNo verificado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en 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
Preguntas sobre Pare Python MCP
¿Cómo agrego Pare Python MCP a Claude Code?
Ejecuta claude mcp add pare-python -- npx -y @paretools/python en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Pare Python MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué devuelve Pare Python en lugar de la salida bruta de la terminal?
Devuelve un JSON limpio y validado con esquemas, con nombres de campos consistentes para herramientas de Python como ruff, mypy, pip, uv, black y pytest.
¿Qué herramientas de Python integra Pare?
El servidor de Python de Pare integra pip entre las herramientas de lenguaje y paquetes, y cubre pytest en su conjunto de herramientas de testing.
¿Las herramientas de Pare ofrecen salida tanto legible para humanos como tipada?
Sí, cada herramienta devuelve texto legible para humanos en content y un JSON tipado y validado mediante esquemas en structuredContent.
¿Puedo limitar qué herramientas registra un servidor de Pare?
Sí, utiliza variables de entorno por servidor como PARE_PYTHON_TOOLS para registrar solo las herramientas seleccionadas.
¿Reduce Pare el uso de tokens en comandos verbosos?
Sí, la salida estructurada es más pequeña que el texto bruto de la terminal, con reducciones significativas en la salida verbosa de instalación y construcción.