JinDaGe - pje-mcp-server MCP Details

article

README

🚀 🔐 PJE MCP 服务器

这是一个用于与巴西电子司法流程系统（PJE）集成的 MCP（模型上下文协议）服务器，它全面支持 A1 和 A3 数字证书。

🚀 快速开始

该服务器具备以下特性，能助力你高效集成 PJE 系统：

✅ 与 PJE 完全集成 - 可全面访问 PJE 的 API。
🔐 数字证书支持 - 支持 A1（文件）和 A3（令牌/智能卡）证书。
📋 流程管理 - 可列出、搜索和跟踪流程。
🏛️ 司法数据获取 - 获取审判机构、案件类别和主题信息。
🔍 高级筛选功能 - 支持多条件搜索。
🌐 多法院适配 - 可与任何 PJE 法院系统配合使用。
🤖 Claude Desktop 集成 - 与人工智能进行原生集成。

✨ 主要特性

全面集成 PJE：能够完全访问 PJE 的 API，实现与巴西电子司法流程系统的无缝对接。
数字证书支持：提供 A1（文件形式）和 A3（令牌/智能卡形式）数字证书的支持，保障系统的安全性和合法性。
流程管理功能：支持列出、搜索和跟踪司法流程，方便用户对案件进行管理。
司法数据获取：可获取审判机构、案件类别和主题等司法相关数据，为用户提供全面的信息支持。
高级筛选搜索：具备多条件搜索功能，使用户能够更精准地查找所需信息。
多法院兼容性：适用于任何 PJE 法院系统，具有广泛的适用性。
AI 集成能力：与 Claude Desktop 进行原生集成，引入人工智能技术提升用户体验。

📦 安装指南

快速安装步骤

git clone https://github.com/seu-usuario/pje-mcp-server.git
cd pje-mcp-server
npm install
cp .env.example .env
# 编辑 .env 文件并配置你的设置
npm run build

💻 使用示例

与 Claude 配合使用

在完成配置后，重启 Claude Desktop 即可使用自然语言命令，例如：

"Configure o PJE do TJCE"
"Liste meus processos"
"Busque o processo 1234567-89.2024.8.06.0001"
"Mostre os órgãos julgadores"
"Quais são minhas audiências esta semana?"

📚 详细文档

配置说明

1. 基础配置（.env 文件）

# 法院的 URL
PJE_BASE_URL=https://pje.tjce.jus.br
PJE_APP_NAME=pje-tjce-1g

# 数字证书（选择一种方式）
# 选项 1: PFX 文件
PJE_CERTIFICATE_PFX_PATH=C:\certificado.pfx
PJE_CERTIFICATE_PFX_PASSWORD=senha123

# 选项 2: Windows 存储
PJE_CERTIFICATE_THUMBPRINT=abc123...

2. Claude Desktop（Windows）配置

在 %APPDATA%\Claude\claude_desktop_config.json 文件中添加以下内容：

{
  "mcpServers": {
    "pje": {
      "command": "node",
      "args": ["C:\\caminho\\para\\pje-mcp-server\\build\\index.js"]
    }
  }
}

3. Claude Desktop（Mac/Linux）配置

在 ~/.config/claude/claude_desktop_config.json 文件中添加以下内容：

{
  "mcpServers": {
    "pje": {
      "command": "node",
      "args": ["/caminho/para/pje-mcp-server/build/index.js"]
    }
  }
}

数字证书说明

识别证书（Windows）

certutil -store My

支持的证书类型

| 属性 | 详情 | |------|------| | 证书类型 | A1（.pfx/.p12 文件）、A3（令牌/智能卡） | | 配置项 | A1 对应 PJE_CERTIFICATE_PFX_PATH；A3 对应 PJE_CERTIFICATE_THUMBPRINT |

认证机构

SERPRO
Certisign
Serasa Experian
Valid
Soluti
AC Caixa

测试法院

TJCE - 塞阿拉州司法法院
TRF5 - 第五地区联邦法院
TJMG - 米纳斯吉拉斯州司法法院
TJSP - 圣保罗州司法法院
TJRJ - 里约热内卢州司法法院

可用命令

配置命令

pje_configurar - 配置与法院的连接
pje_configurar_certificado - 配置数字证书
pje_listar_certificados - 列出已安装的证书
pje_info_certificado - 显示当前证书的信息
pje_status - 查看配置状态

查询命令

pje_listar_processos - 列出带有筛选条件的流程
pje_buscar_processo - 按编号搜索流程
pje_listar_orgaos_julgadores - 列出审判机构
pje_listar_classes - 列出诉讼类别
pje_listar_assuntos - 列出可用的主题

开发说明

项目结构

pje-mcp-server/
├── src/                    # TypeScript 源代码
│   ├── index.ts           # 主服务器文件
│   ├── certificate-manager.ts  # 证书管理文件
│   └── types.ts           # 类型和接口文件
├── build/                 # 编译后的代码（自动生成）
├── docs/                  # 额外的文档
├── examples/              # 配置示例
└── package.json          # 项目配置文件

可用脚本

npm run build    # 编译 TypeScript 代码
npm run start    # 启动服务器
npm run dev      # 编译并启动服务器
npm run clean    # 清理编译后的文件

问题解决

错误：“Certificado não encontrado”（未找到证书）

# 列出可用的证书
certutil -store My
# 将正确的指纹复制到 .env 文件中

错误：“Comando não encontrado”（未找到命令）

完全重启 Claude Desktop。
检查 claude_desktop_config.json 文件中的路径。

错误：“Autenticação falhou”（认证失败）

检查证书的有效性。
确认法院的 URL。
尝试使用其他证书。

🔧 技术细节

项目结构

项目采用了清晰的结构，便于开发和维护：

src 目录：存放 TypeScript 源代码，包含主服务器文件 index.ts、证书管理文件 certificate-manager.ts 以及类型和接口文件 types.ts。
build 目录：用于存放编译后的代码，由项目自动生成。
docs 目录：提供额外的文档资料。
examples 目录：包含配置示例，方便用户参考。
package.json 文件：对项目进行配置管理。

开发脚本

项目提供了一系列开发脚本，方便开发者进行编译、启动和清理等操作：

npm run build：将 TypeScript 代码编译为可执行的代码。
npm run start：启动服务器。
npm run dev：同时进行编译和启动服务器的操作，提高开发效率。
npm run clean：清理编译生成的文件，保持项目的整洁。

🤝 贡献指南

如果你想为这个项目做出贡献，可以按照以下步骤进行：

Fork 项目：在 GitHub 上 Fork 该项目到自己的仓库。
创建功能分支：使用 git checkout -b feature/NovaFuncionalidade 创建新的功能分支。
提交更改：使用 git commit -m 'Add: Nova funcionalidade' 提交你的更改。
推送分支：使用 git push origin feature/NovaFuncionalidade 将分支推送到你的仓库。
发起 Pull Request：在 GitHub 上发起 Pull Request，等待审核和合并。

📄 许可证

本项目采用 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。

🔗 有用链接

📞 支持渠道

问题反馈：GitHub Issues
讨论交流：GitHub Discussions
邮件联系：seu-email@exemplo.com

本项目由开发者怀着对巴西司法界的热爱精心打造。

pje-mcp-server

README

🚀 🔐 PJE MCP 服务器

🚀 快速开始

✨ 主要特性

📦 安装指南

快速安装步骤

💻 使用示例

与 Claude 配合使用

📚 详细文档

配置说明

1. 基础配置（.env 文件）

2. Claude Desktop（Windows）配置

3. Claude Desktop（Mac/Linux）配置

数字证书说明

识别证书（Windows）

支持的证书类型

认证机构

测试法院

可用命令

配置命令

查询命令

开发说明

项目结构

可用脚本

问题解决

错误：“Certificado não encontrado”（未找到证书）

错误：“Comando não encontrado”（未找到命令）

错误：“Autenticação falhou”（认证失败）

🔧 技术细节

项目结构

开发脚本

🤝 贡献指南

📄 许可证

🔗 有用链接

📞 支持渠道

Runtime guide

Hosted runtime

Local runtime / other methods