PJe-Calc MCP

PJe-Calc MCP

支持项目

请我喝杯咖啡
_{Pix 二维码：打开银行应用，选择 Pix > 扫描二维码，然后对准摄像头。}

上图是一个 Pix 二维码。如果这个工具为您节省了时间，不妨请我喝杯咖啡。您的捐助有助于保持项目更新并持续运行：跟进 PJe-Calc 和各类表格的新版本、修复实际计算中发现的故障，并加入新的计算类型。

投诉、想法、发现的故障或建议： [email protected]

---

将安装在您电脑上的 AI 助手——Claude Desktop、 Claude Code、Codex、Cursor、VS Code 等——连接到 PJe-Calc Cidadão，即劳动法院的官方计算程序。

您将判决和案件文件交给助手。它会在 PJe-Calc 中完成整套劳动计算，而您只需核对并点击结算。

不能在浏览器中打开的 AI 聊天（claude.ai、chatgpt.com、Gemini、Copilot 网页版等）或手机应用中使用。助手必须在安装了 PJe-Calc 的同一台 Windows 电脑上运行。请参阅适用和不适用场景。

辅助工具。 计算由 PJe-Calc 自身完成，但根据您提供的内容决定纳入哪些项目的是助手。用于案件前，请务必核对结果。助手应说明采用的前提，以及文件中不明确的内容。

请使用最先进的 AI 模型。 阅读完整案件（数百页、经过改判的裁决、逐日考勤卡）需要您能使用的能力最强的模型：Codex 中的 GPT-6 Luna 或更高版本、Claude 中的 Claude Sonnet 5.5 或更高版本（例如 Claude Opus 5.5），以及其他助手中同代的对应模型。请参阅应使用哪个模型。

最简单的方法：将链接粘贴到您的 Agent 中

如果您已在电脑上使用 AI Agent（Claude Code、Claude Desktop、Codex、 Cursor、带 Copilot 的 VS Code 等），只需将链接粘贴到其中：

https://github.com/lucianumm/PJeCalcMCP

例如：*“请为我安装并配置此 MCP：https://github.com/lucianumm/PJeCalcMCP”*。Agent 会按照下方的 Agent 安装说明下载、安装并注册该工具。

将链接粘贴到浏览器中打开的聊天（claude.ai、chatgpt.com 等）不会安装任何内容：该聊天运行在公司的服务器上，无法访问您的电脑。它或许能介绍此项目，但无法下载、安装或操作 PJe-Calc。如果您还没有电脑端 Agent，请参阅适用场景中的表格，或使用手动安装，无需任何 Agent。

重要： 您必须在电脑上安装（下载并解压）PJe-Calc Cidadão 2.16。此工具操作的是您电脑上的 PJe-Calc：它不会取代或附带该程序。没有 PJe-Calc，一切都无法运行。

它的功能

• 在 PJe-Calc 中完成完整的计算：
  • 案件和当事人信息、合同日期和薪资；
  • 缺勤、休假和考勤卡（包括根据工作时间计算加班时数）；
  • 各项款项及其连带影响；当文件要求时，按月填写金额（每张工资单实际支付的金额、某个月的数量）；
  • PJe-Calc 表格中的最低工资和交通补贴；
  • FGTS、INSS、所得税、抚养费、私人养老保险、家庭津贴、失业保险金，并按发生事项页面中的归属期间调整（FGTS 缴存基数和缴存额、已缴纳的 INSS 工资和缴费，包括批量调整）；
  • 律师费（包括按选定款项计算）、罚款、诉讼费用（包括固定费用、卷宗和存储费用）、货币调整和利息。
• 在执行阶段，根据付款（存款、付款令）、律师费、罚款、抚养费和执行费用（按事项、卷宗和存储计费）以及预付款令或小额付款请求，更新已获法院批准的计算结果；也会更新在 PJe-Calc 之外完成的计算（外部计算）。一次可进行多项计算（每位申诉人或每位债务人各一项）。
• 帮助阅读文件：列出页面（以及需要以图像形式查看的扫描页），提取 PDF 文本和扫描页图像，以便助手查看；并核对转录的工资单、考勤卡、FGTS 对账单和 TRCT（合计、缺失月份、不可能的考勤记录）。还会利用 AuditorProcessual 完成的阅读结果：根据 PJe 页脚拆分文件和页面，并整理出工作时间、工资单和合同事件。
• 在计算前对案件进行全面司法审计：从起诉书中的每项诉求到已生效的最终裁定，逐月核查财务文件、逐日核查考勤卡，并检查 PJe-Calc 每个选项卡的参数设置，同时指出缺漏和矛盾。
• 在清算前，根据案件所属法院更新 PJe-Calc 的指数表。
• 核对 PJe-Calc 的计算结果：独立重新计算各项金额（款项、利息、FGTS、INSS、所得税、律师费、诉讼费用），并与程序报告精确到分地对比；核对各项金额之和、负数金额、未参与计算的款项、系统采用的标准，以及 PJe-Calc 自身的验证规则。
• 与另一份计算结果（法务会计师、当事人或其他方案的结果）进行比较，包括 PDF 报告或转录的计算结果，并说明每项差异的来源。
• 提供计算文件（-PRONTO.PJC），可在任何 PJe-Calc 2.16 中打开并直接进行清算；清算后还会提供完整的 PJe-Calc PDF 报告（-RELATORIO.pdf），内容包括摘要、数据、缺勤和休假、工资历史、考勤卡、每项款项的明细（包括基数、除数、倍数和数量〔天数和时数〕）、利息、FGTS、社会保险缴费、所得税、律师费、诉讼费用和说明，并且只包含适用于该项计算的章节。

所有操作都在您的电脑上运行。PJe-Calc 会在后台打开并运行，无需您操作；此工具不会将案件数据发送给任何第三方。您使用的 AI 助手将遵循其自身规则。

适用场景与不适用场景

为什么需要在电脑上运行 Agent

此工具是一个 MCP 服务。MCP（Model Context Protocol） 是一种标准，可让 AI 助手使用电脑上的程序。在这里，助手通过该服务来：

• 打开并在后台操作安装在你电脑上的 PJe-Calc；
• 读取你文件夹中的案件文档；
• 创建、导入、结算和导出计算结果；
• 将 .PJC 文件和报告保存到你的磁盘。

因此，助手必须是安装在运行 PJe-Calc 的同一台 Windows 电脑上并已打开的程序，而且必须支持本地 MCP 服务。在某家公司网站上运行的聊天工具看不到你的电脑：对它来说，PJe-Calc 和你的文件都不存在。

可以使用（安装在 Windows 上的助手）

助手	介绍	下载地址（官方网站）	MCP 接入方式
Claude Desktop	Anthropic 为 Windows 提供的应用，包含聊天和代码标签页	https://claude.com/download	一键扩展（.mcpb）或安装程序
Claude Code	Anthropic 的 Agent，可在终端、VS Code、JetBrains 和 Claude Desktop 中使用	https://claude.com/product/claude-code（MCP 文档：https://code.claude.com/docs/en/mcp）	安装程序会自动注册（命令 claude mcp add）
Codex	OpenAI 的 Agent，可在终端、编辑器扩展和应用中使用	https://github.com/openai/codex（文档：https://developers.openai.com/codex）	安装程序会自动注册（~/.codex/config.toml）
Cursor	带有 AI Agent 的代码编辑器	https://cursor.com/download（MCP 文档：https://cursor.com/docs/mcp）	安装程序会自动注册
VS Code 搭配处于 Agent 模式的 GitHub Copilot	Microsoft 的编辑器	https://code.visualstudio.com（MCP 文档：https://code.visualstudio.com/docs/agent-customization/mcp-servers）	安装程序会自动注册
Windsurf，现称为 Devin Desktop	带有 AI Agent 的编辑器	https://devin.ai/desktop	安装程序会将其注册到 Windsurf 配置中；如果 Devin Desktop 中没有显示，请使用 mcp-config.json 手动注册

每个助手都有自己的账号和套餐规则，请在其网站上查看。任何其他支持本地 MCP 服务的程序也可以使用；注册示例见 mcp-config.json。

不可以使用

场景	原因
浏览器中的 AI 聊天工具：claude.ai、chatgpt.com、gemini.google.com、网页版 Copilot 等	它们运行在公司服务器上，无法访问你的电脑或 PJe-Calc
手机和平板应用（Claude、ChatGPT、Gemini……）	PJe-Calc 只能在 Windows 电脑上运行
在云端运行的 Agent：网页版 Claude Code、云端 Codex（通过 ChatGPT 网站使用）等	它们运行在远程虚拟机上，没有你的 PJe-Calc 和文件
通过网站或应用使用的 ChatGPT	只支持连接到互联网的连接器，不支持在你电脑上运行的 MCP 服务；OpenAI 提供的可用选项是 Codex
macOS 或 Linux 电脑	此工具和安装程序仅针对 Windows 上的 PJe-Calc 开发和测试

电脑关机或助手关闭时也无法使用：助手会在与你聊天的同时操作 PJe-Calc。

使用哪个模型

MCP 会检查算术和 PJe-Calc 的规则，但阅读案件材料并决定哪些内容纳入计算的是 AI 模型。较小或速度较快的模型会跳过页面、混淆被改判的裁决，还会弄错日期。为提高准确性：

助手	推荐模型
Codex (OpenAI)	GPT-6 Luna 或更高版本
Claude Desktop 和 Claude Code (Anthropic)	Claude Sonnet 5.5 或更高版本（例如 Claude Opus 5.5）
Cursor、带 Copilot 的 VS Code、Windsurf/Devin Desktop 及其他产品	可用的最新一代模型，与上述模型属于同一代

• 在助手自身的选择器中选择模型。如果有推理等级（“投入程度”，reasoning effort），阅读案件材料并制定计划时请使用最高等级。
• 不建议使用前几代模型或“mini”和“快速”版本来编制计算；它们最多适合回答关于 PJe-Calc 的简单问题。
• 任何模型都不能替代你的审核：解释计划是为了让你在计算前核对助手的理解。

如何确认是否正常运行

1. 安装后，关闭并重新打开助手。
2. 提问：“检查 PJe-Calc MCP 是否正常运行。”
3. 助手应使用以 pjecalc_、calculo_、catalogo_……开头的工具（例如 pjecalc_status），并回答是否找到了 PJe-Calc，以及它是否已打开。

如果助手表示没有这些工具，说明它没有加载 MCP：运行 Conferir PJe-Calc MCP.bat 查看缺少什么，并确认所用助手是上表中的一种。

所需条件

• 一台安装了 Windows 的电脑。
• **必需：**已安装 PJe-Calc Cidadão 2.16，也就是已下载并解压（可从 TRT 8ª Região 官方网站获取）。它可以位于任意文件夹：安装程序会自动找到。
• 一款安装在电脑上且兼容 MCP 的 AI 助手：Claude Desktop、Claude Code、Codex、Cursor、带 Copilot 的 VS Code 或 Windsurf/Devin Desktop（请参阅包含官方链接的表格）。浏览器中的聊天工具不适用。

安装方法

Claude Desktop：一键安装扩展

1. 从版本页面下载 pjecalc-mcp-<versão>.mcpb 文件。
2. 双击该文件（或者在 Claude Desktop 中打开 设置 > 扩展，并将文件拖到窗口中），然后确认安装。
3. 完成。扩展中的字段均为选填：PJe-Calc 文件夹（留空时，MCP 会自动查找）和生成的计算文件夹（留空时使用 Documentos\PJe-Calc MCP）。

Claude Desktop 已自带 Node.js；除了 PJe-Calc，无需安装其他内容。

适用于任何助手：Windows 安装程序

1. 从版本页面下载 .zip 文件，并解压到任意文件夹。
2. 双击 Instalar PJe-Calc MCP.bat。安装程序将：
   • 如果电脑上没有 Node.js，则下载官方便携版（不会在 Windows 中安装任何内容，也不会要求管理员密码）；
   • 在电脑上查找 PJe-Calc。如果有多个安装版本，会询问要使用哪一个；如果没有，则说明如何处理；
   • 询问要在哪些助手中注册，并保存这些助手配置的备份；
   • 执行快速测试。
3. 关闭并重新打开助手。

文件夹中的其他文件：

• Conferir PJe-Calc MCP.bat 会检查是否一切正常，以及还缺少什么。
• Desinstalar PJe-Calc MCP.bat 会从助手中移除注册信息。不会改动 PJe-Calc 或你的计算文件。

面向 Agent 的说明（自动安装）

如果你是为用户安装此工具的 AI 助手：

0. 确认你运行在用户的电脑上，可以访问磁盘和 Windows 终端，并且支持本地 MCP 服务（stdio）。如果你是在浏览器中运行的聊天助手，或是云端 Agent，请勿尝试安装：向用户说明，他们需要安装在电脑上的助手（参见适用场景中的表格）或手动安装。

1. 确认已安装 PJe-Calc Cidadão 2.16。 它位于一个包含 bin 和 tomcat 的文件夹中，该文件夹从 TRT da 8ª Região 官方网站下载并解压。如果尚未安装，请让用户下载并解压 PJe-Calc。未完成此步骤前请勿继续。

2. 下载最新版本并解压到用户文件夹中。 文件 PJeCalcMCP-<版本>.zip 位于 https://github.com/lucianumm/PJeCalcMCP/releases/latest。也可以运行 git clone https://github.com/lucianumm/PJeCalcMCP。

3. 在解压后的文件夹中运行安装程序。

   • 交互式安装，与 Instalar PJe-Calc MCP.bat 相同：询问要注册到哪些助手。

     powershell -NoProfile -ExecutionPolicy Bypass -File instalador\iniciar.ps1 instalar
     

   • 无需交互：先设置 $env:INSTALADOR_SIM='1'。安装程序会将其注册到找到的所有助手中。

   安装程序会确保使用 Node.js 20 或更高版本（若缺少，则下载官方便携版），定位 PJe-Calc，备份设置后注册服务，并执行测试。如果安装程序找不到 PJe-Calc 所在的文件夹，请将 PJECALC_HOME 设置为该文件夹。

4. 替代方案：仅注册你自己的助手。 使用 MCP 服务（stdio） node <文件夹>\server\server.mjs，并将 PJECALC_HOME 指向 PJe-Calc。mcp-config.json 中提供了 Claude、Codex、Cursor、VS Code 和 Windsurf 的配置示例。在 Claude Code 中： claude mcp add pjecalc --scope user -e PJECALC_HOME=<PJe-Calc 文件夹> -- node <文件夹>\server\server.mjs。

5. 检查安装。 运行 instalador\iniciar.ps1 conferir，并让用户重新打开助手。

6. 要创建计算，请按照 SKILL.md 操作。 首先索取相关文档 （calculo_documentos_necessarios），绝不要直接在 PJe-Calc 数据库中写入计算数据。

使用方法

像平常一样与助手对话，例如：

在 PJe-Calc 中计算这份判决。以下是判决书、上诉判决、工资单和考勤卡。

或者，先进行全面分析再计算：

对该案件进行全面的司法鉴定审计，并向我展示计划。

助手会：

1. 确定案件所处阶段，以及与其相关的其他案件（之前的诉讼、集体诉讼、和解、司法重组……）；
2. 索取案件所需的文档（判决书、上诉判决、工资单、考勤卡、TRCT、FGTS 对账单、其他案件的文档……），并核实文档是否涵盖整个期间；
3. 阅读所有页面，包括扫描件，并索取缺少的补充材料；
4. 根据所有裁决（审判法院、TRT、TST、STF、清算和执行）确定判决依据；
5. 显示解读计划，供你在计算前批准；
6. 在 PJe-Calc 中创建计算，并更新你所在法院的指数表；
7. 显示金额、核查结果和已准备好的文件。

例如，在执行阶段：

将已裁定的计算（附件文件）更新至今天，扣除第 300 页的存款和第 330 页的支付令，并计入执行费用。

之后，只需打开 PJe-Calc，在“打开最近的计算”中选择该计算，核对后点击操作 > 清算。

简而言之，它如何工作

PJe-Calc 提供官方的计算导出和导入功能（.PJC 文件）。此工具会根据助手从文档中提取的信息生成该文件。

它会将文件导入你电脑上的 PJe-Calc，并通过程序自身的界面完成最后几步：重新生成各项款项、核算考勤卡、更新表格、进行清算，以及在执行阶段清算更新金额。这样，所有计算都由 PJe-Calc 的官方计算引擎完成。

我们通过将此工具生成的计算结果与在 PJe-Calc 界面中手动完成的相同计算进行比较，测试了该工具，其中还包括有付款记录的更新计算和外部计算。结果完全一致，精确到分。

常见问题

可以在浏览器中使用 ChatGPT、Claude 或 Gemini 吗？ 不可以。浏览器中的聊天和手机应用运行在服务提供商的服务器上，无法访问你的电脑，而 PJe-Calc 和文档都在电脑上。请使用安装在 Windows 上的助手：Claude Desktop、Claude Code、Codex、Cursor、带 Copilot 的 VS Code，或 Windsurf/Devin Desktop（链接见表格）。

我有 ChatGPT 账号，可以使用吗？ 不能通过 ChatGPT 网站或应用使用。OpenAI 提供的可用方案是安装在电脑上的 Codex（https://github.com/openai/codex）。通过网站打开的云端 Codex 也无法使用，因为它运行在远程机器上。

我有 Claude 账号，可以使用吗？ 可以使用安装在电脑上的 Claude Desktop（https://claude.com/download）或 Claude Code（https://claude.com/product/claude-code）。不能通过 claude.ai 网站、手机应用或网页版 Claude Code 使用。

我需要会编程吗？ 不需要。安装完成后，你可以像平常一样与助手对话。Claude Code 和 Codex 可以在终端中运行，但也提供应用或编辑器扩展；Claude Desktop 则是普通应用。

它在哪里查找 PJe-Calc？ 按以下顺序查找：

1. 上次选择的文件夹；
2. 当前打开的 PJe-Calc 所在位置；
3. 工具解压所在的文件夹；
4. Downloads、Área de Trabalho、Documentos、Arquivos de Programas 和各磁盘根目录。

如果你更改了 PJe-Calc 所在的文件夹，它会自动重新查找。

需要联网吗？ 仅在安装时下载 Node.js，以及更新 PJe-Calc 的指数表时需要联网。

可以与多个助手搭配使用吗？ 可以。安装程序会为你选择的所有助手完成注册。

结果有保证吗？ 没有。PJe-Calc 会根据输入的信息正确计算，但你需要核对对判决和文档的解读。为方便核对，计算中的每项信息都关联到其来源文档和对应的裁决段落，并且工具会标明计算所处的状态：

• 已被应用接受：PJe-Calc 已接受；
• 已计算：已核对数值，包括确认没有任何款项未计算；
• 模拟：计算依赖于尚未裁定的假设（例如一张存在争议的收据）；
• 已审计：每个项目都有证据和适用裁决作为依据，没有未解决的疑问，警告已复核，且计划已获你批准；
• 暂定：标记仍可能被上诉的裁决。

无论哪种情况，最终审核都由你负责。计算还会记录所用版本和数据，以便日后复现。

说明文档位置

• SKILL.md：助手在整个计算过程中遵循的规则。
• references/：所有支持的字段、数据约定、司法鉴定审计流程，以及按主题整理的核对内容（文档阅读、工时、付款、FGTS 和税费、更新、执行、参考计算）。
• exemplos/：可直接用作模板的完整计算示例。
• scripts/：测试。

致谢

由 Lucianum 创建并维护 — Instagram @lucianum · GitHub @lucianumm

免责声明

本项目独立开发，与劳动法院无关。PJe-Calc Cidadão 不属于本仓库，须从官方网站下载。

许可证

Copyright (C) 2026 Lucianum。

根据 GNU Affero 通用公共许可证 v3.0（AGPL-3.0）分发。您可以自由使用、研究、修改和再分发。分发修改版本或通过网络将其作为服务提供的人，必须按照相同许可证公开源代码。