ruff, mypy, pip, uv, black, pytest와 같은 Python CLI 도구에 대해 스키마 검증이 완료된 구조화된 JSON을 반환합니다.
다른 이름 Dave-London/Pare, @paretools/python
- 스타
- 141
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.8.1
- 마지막 커밋
- 2026년 11월 10일
- 라이선스
- MIT
Pare Python MCP란?
Pare Python은(는) MCP server입니다. 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
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과 같은 상세 출력 명령의 경우 토큰 사용량을 크게 줄여줍니다.