Skip to content

Latest commit

 

History

History

README.md

@paretools/python

npm License: MIT

Structured, token-efficient Python tool output for AI agents. Up to 65% fewer tokens than raw CLI output.

Part of the Pare suite of MCP servers.

Tools (8)

Tool Description
pip-install Install packages, returns summary of installed items
mypy Type-check diagnostics (file, line, severity, message)
ruff-check Lint diagnostics (file, line, code, message)
pip-audit Vulnerability report for installed packages
pytest Run tests, returns structured pass/fail results
uv-install Install packages via uv with structured summary
uv-run Run a command in a uv-managed environment
black Format code with Black, returns changed/unchanged files

Quick Start

npx -y @paretools/python

Add to your MCP client config:

{
  "mcpServers": {
    "pare-python": {
      "command": "npx",
      "args": ["-y", "@paretools/python"]
    }
  }
}

Example

mypy output:

{
  "success": false,
  "errors": [
    {
      "file": "app/main.py",
      "line": 15,
      "severity": "error",
      "message": "Argument 1 to \"process\" has incompatible type \"str\"; expected \"int\"",
      "code": "arg-type"
    }
  ],
  "errorCount": 1,
  "warningCount": 0,
  "noteCount": 0
}

All Pare Servers (240 tools)

Package Tools Wraps
@paretools/git status, log, diff, branch, show, add, commit, push, pull, checkout git
@paretools/test run, coverage pytest, jest, vitest, mocha
@paretools/npm install, audit, outdated, list, run, test, init npm
@paretools/build tsc, build, esbuild, vite-build, webpack tsc, esbuild, vite, webpack
@paretools/lint lint, format-check, prettier-format, biome-check, biome-format eslint, prettier, biome
@paretools/python pip-install, mypy, ruff-check, pip-audit, pytest, uv-install, uv-run, black pip, mypy, ruff, pytest, uv, black
@paretools/docker ps, build, logs, images, run, exec, compose-up, compose-down, pull docker, docker compose
@paretools/cargo build, test, clippy, run, add, remove, fmt, doc, check cargo
@paretools/go build, test, vet, run, mod-tidy, fmt, generate go, gofmt

Compatible Clients

Works with any MCP-compatible client: Claude Code, Claude Desktop, Cursor, Windsurf, VS Code / GitHub Copilot, Cline, Roo Code, Zed, Continue.dev, Gemini CLI, OpenAI Codex

Links

License

MIT