Возвращает структурированный JSON с валидацией по схеме для таких Python CLI инструментов, как ruff, mypy, pip, uv, black и pytest.
Также известен как Dave-London/Pare, @paretools/python
- Звёзды
- 141
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- 0.8.1
- Последний коммит
- 10 нояб. 2026 г.
- Лицензия
- MIT
Что такое Pare Python MCP?
Возвращает структурированный JSON с валидацией по схеме для таких Python CLI инструментов, как ruff, mypy, pip, uv, black и pytest.
Сводка сгенерирована из README проекта
О Pare Python MCP server
pare-python позволяет AI-агентам получать структурированный JSON с валидацией по схеме для инструментов разработки на Python. Вместо того чтобы заставлять агента парсить нестабильный текстовый вывод терминала, содержащий ANSI-коды или специфическое для платформы форматирование, этот сервер преобразует вывод CLI инструментов в типизированные данные. Это позволяет разработчикам использовать такие AI-клиенты, как Claude Desktop, Cursor или Windsurf, для взаимодействия со своей Python-средой с гораздо более высокой надежностью.
Сервер оборачивает распространенные команды, такие как ruff, mypy, pip, uv, black и pytest. Возвращая structuredContent вместо сырых строк, он значительно снижает расход токенов — часто более чем на 60% для таких подробных команд, как pip install. Пользователи могут настроить, какие именно инструменты будут доступны их агенту, используя переменные окружения, такие как PARE_PYTHON_TOOLS, чтобы поддерживать минимальный и сфокусированный набор инструментов. Такая конфигурация идеально подходит разработчикам, которые хотят, чтобы их AI-ассистенты выполняли линтинг, проверку типов и управление зависимостями без риска ошибок парсинга или поломки регулярных выражений.
Что вы можете с ним делать
- 1Автоматизированное управление зависимостямиAI-агент может устанавливать Python-пакеты с помощью pip и получать структурированный список установленных элементов вместо полотна текста.
- 2Надежный линтинг и форматирование кодаРазработчики могут поручить агенту запуск ruff или black, чтобы обеспечить качество кода на основе типизированной обратной связи в формате JSON.
- 3Автоматизированное выполнение и анализ тестовАгент может запускать pytest и мгновенно понимать результаты тестов благодаря данным с валидацией по схеме.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Pare Python MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка Pare Python MCP в Claude Code
$ claude mcp add pare-python -- npx -y @paretools/pythonУстановка Pare Python MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"pare-python": {
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}Установка Pare Python MCP в VS Code
.vscode/mcp.json
{
"servers": {
"pare-python": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}Установка Pare Python MCP в VS Code CLI
$ code --add-mcp '{"name":"pare-python","type":"stdio","command":"npx","args":["-y","@paretools/python"]}'Установка Pare Python MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"pare-python": {
"command": "npx",
"args": [
"-y",
"@paretools/python"
]
}
}
}Установка Pare Python MCP в Codex
$ codex mcp add pare-python -- npx -y @paretools/pythonУстановка Pare Python MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.pare-python] command = "npx" args = ["-y", "@paretools/python"]
Установка Pare Python MCP в Gemini CLI
$ gemini mcp add -s user pare-python npx -- -y @paretools/pythonУстановка Pare Python MCP в Gemini settings.json
~/.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 | — |
Автоматические проверки
Запущено 12 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийПройдено
- Open source лицензия (OSI)Пройдено
- Коммит или релиз за последний годПройдено
- Имя пакета не похоже на популярный пакетПройдено
- Удаленная конечная точка использует HTTPSНе проверялось
- Деструктивные инструменты помеченыНе проверялось
- Нет скрытых инструкций для моделиПройдено
- Нет критических предупреждений в пакете или его зависимостяхПройдено
README
Открыть на 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
Вопросы о 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 и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Что именно возвращает Pare Python вместо обычного вывода терминала?
Он возвращает чистый JSON с валидацией по схеме и согласованными именами полей для таких Python инструментов, как ruff, mypy, pip, uv, black и pytest.
Какие Python инструменты поддерживает Pare?
Python-сервер Pare включает в себя инструменты для работы с языком и пакетами, такими как pip, а также инструменты для тестирования, включая pytest.
Предоставляют ли инструменты Pare как читаемый человеком, так и типизированный вывод?
Да, каждый инструмент возвращает текст, удобный для чтения человека, в поле content, и типизированный JSON с валидацией по схеме в поле structuredContent.
Можно ли ограничить список инструментов, которые регистрирует сервер Pare?
Да, используйте переменные окружения для конкретного сервера, например PARE_PYTHON_TOOLS, чтобы зарегистрировать только выбранные инструменты.
Снижает ли Pare расход токенов при использовании подробных (verbose) команд?
Да, структурированный вывод занимает меньше места, чем сырой текст из терминала, что обеспечивает значительную экономию токенов при использовании подробного вывода команд установки или сборки.