← 返回目录

Pare Python

社区

结构化 Python 工具输出（ruff、mypy、pip、uv、black、pytest），返回类型化 JSON。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 362 / 438
Stars: ★ 138 热门
传输方式: stdio（本地进程）
运行环境: Node.js 20+
凭据: 无需凭据
许可证: MIT
最近提交: 54 天前

39FMRS · D

Pare Python 提供了一个有价值的 MCP 服务器，适合寻求结构化 Python 工具输出以用于 AI 工作流的开发人员。它在令牌效率方面表现出色，但鉴于其作为第三方包装器的性质，可能会存在依赖相关风险。

最强项 · 安装易用性 11/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

6/20

维护活跃度

8/20

文档质量

8/20

安装易用性

11/20

查看各项评分依据

可靠性 6/20: 证据：manifest 是有效 JSON，声明了单一 stdio 包 @paretools/python 和版本 0.22.0；README 描述了 Pare 的 structuredContent/outputSchema 架构，并列出该服务器封装 ruff、mypy、pip、uv、black、pytest。扣分：未提供 server-python 的源码、工具清单、单元/集成测试或 CI 日志；仓库级 CI/codecov 徽章不能归属于该服务器，因此工具是否与真实行为一致、MCP 初始化握手和错误路径均无法验证。不确定性要求保守评分，故不高于 12，取 6。
安全与权限 6/20: 证据：服务器描述表明它会调用 pip、uv、pytest、black、ruff 等可执行第三方代码或修改文件的命令，风险面可见；无凭据处理或外部网络数据流描述。扣分：未提供源码，无法检查最低权限、命令确认、参数白名单、危险操作确认或数据流披露；README 的 PARE_TOOLS 过滤只是限制注册工具，不是安全控制。未在提供材料中发现恶意代码、真实令牌或明确外传行为，因此不触发 0-4 红线，但安全设计证据严重不足。
维护活跃度 8/20: 证据：仓库未归档，声明 MIT 许可，manifest 固定 0.22.0 版本，README 提及 CI/codecov/OpenSSF 徽章和 CONTRIBUTING 链接。扣分：没有提交历史、发布时间线、issue 响应记录、依赖更新策略或安全响应渠道；徽章属于仓库级且不可信，不能证明 python 服务器的持续维护状态。因此维护活跃度只能判为 plausible，取 8。
文档质量 8/20: 证据：README 提供通用架构说明、快速配置（preset）、客户端接入指南、工具过滤环境变量和故障排查。扣分：对于 python 服务器只有一句话描述和封装工具列表，没有逐工具的参数、输出 schema、示例、限制、成本说明，也没有 python 专属的配置示例；tool schemas 链接未提供实际内容，不能确证已覆盖该服务器。存在隐藏假设，扣至 8。
安装易用性 11/20: 证据：README 给出 npx @paretools/init --preset python 的安装方式，并列出各客户端 setup 指南；manifest 声明通过 npm 包 @paretools/python 以 stdio 运行，环境要求 Node >=20。扣分：未提供 python 服务器的客户端配置 JSON 示例，也没有该包的实际启动/CI 验证材料；静态校准要求在缺少可验证执行证据时 setup 不超过 15。整体流程简单但尚未被证据充分固化，取 11。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件执行命令或代码

适合谁

主要在 Python 生态系统中工作的 AI 编码代理。
希望在整合开发工具时节省令牌的开发人员。
需要与 ruff、mypy、pip、uv、black、pytest 可靠集成的场景。

不适合谁

不使用 Python 工具的项目。
需要交互式终端会话的任务（如某些 pytest 调试模式）。
没有 Node.js 20+ 或 npm 的环境。

所需权限

执行 Python 工具（ruff、mypy、pip、uv、black、pytest）的权限。
访问文件系统以运行这些工具。
网络访问（如果 pip/uv 需要）。

风险与副作用

执行任意 Python 工具可能会产生意外副作用（如安装包）。
如果未正确配置环境路径，工具结果可能不准确。
依赖外部工具版本，这些版本可能会改变输出格式。

安装接入

准备工作

运行环境：Node.js 20+

其他可选配置项（1 个）

PARE_TOOLS 可选通用工具过滤器，格式为 server:tool,tool，限制所有服务器注册的工具，例如 git:status,npm:install。

在 MCP 客户端配置中添加以下内容：

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

或使用 npx @paretools/init --preset python 快速设置。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add pare-python -- npx -y @paretools/python

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端 MCP 配置中加入 pare-python 服务器并重启，工具列表中应出现 pare-python 注册的工具；运行一次 ruff 或 pytest 相关工具，确认返回的是 JSON 结构化结果而非原始文本。

常见排障

确保 Node.js 20+ 已安装：`node --version`。
验证 npx 已在 PATH 中；对于 Windows，使用 `cmd /c npx`。
检查 Python 工具是否已安装并可在 PATH 中访问。
如果启动缓慢，请先运行 `npx -y @paretools/python` 以填充缓存。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 ruff 检查这个项目并给出结构化结果
运行 pytest 并告诉我哪些测试失败了
用 mypy 对项目做类型检查
把 black 格式化应用到这个仓库

使用场景

为 Python 开发工具获取稳定的、机器可读的输出以用于 AI 驱动的编码任务。

减少处理命令行输出时 AI 代理的令牌使用。

在无需解析进度条或 ANSI 转义码的情况下自动化 Python 工作流（如 lint、类型检查、测试）。

支持客户端

Claude Desktop

Claude Code

Cursor

依据项目文档列出，未经本站实测。

详细介绍

Pare Python 是一个 MCP 服务器，包装常见的 Python 开发工具（ruff、mypy、pip、uv、black、pytest），将其命令行输出转换为结构化的、schema 验证的 JSON。这消除了解析模糊终端文本的需要，为 AI 代理提供可靠、类型化的数据，减少令牌消耗并提高工作流稳定性。