PJE MCP Server

Instructions

Implementation Reference

• src/index.ts:523-588 (handler)

  The main handler function for the 'pje_status' tool. It generates a detailed status report of the PJE configuration, environment variables, client status, and authentication details.

  private async verificarStatus() {
    const envConfig = {
      baseUrl: process.env.PJE_BASE_URL,
      appName: process.env.PJE_APP_NAME,
      ssoUrl: process.env.PJE_SSO_URL,
      clientId: process.env.PJE_CLIENT_ID,
      clientSecret: process.env.PJE_CLIENT_SECRET,
      username: process.env.PJE_USERNAME ? '***' : undefined,
      password: process.env.PJE_PASSWORD ? '***' : undefined,
      certificatePath: process.env.PJE_CERTIFICATE_PFX_PATH,
      certificatePassword: process.env.PJE_CERTIFICATE_PFX_PASSWORD ? '***' : undefined,
      certificateThumbprint: process.env.PJE_CERTIFICATE_THUMBPRINT,
    };
  
    let statusText = `🔍 **STATUS DO PJE MCP SERVER**\n\n`;
    statusText += `🔧 **Configuração do arquivo .env:**\n`;
    statusText += `- URL Base: ${envConfig.baseUrl || '❌ Não configurado'}\n`;
    statusText += `- App Name: ${envConfig.appName || '❌ Não configurado'}\n`;
    statusText += `- SSO URL: ${envConfig.ssoUrl || '❌ Não configurado'}\n`;
    statusText += `- Client ID: ${envConfig.clientId || '❌ Não configurado'}\n`;
    statusText += `- Client Secret: ${envConfig.clientSecret || '❌ Não configurado'}\n`;
    statusText += `- Username: ${envConfig.username || '❌ Não configurado'}\n`;
    statusText += `- Password: ${envConfig.password || '❌ Não configurado'}\n\n`;
    
    statusText += `🔐 **Certificado Digital:**\n`;
    statusText += `- Arquivo PFX: ${envConfig.certificatePath || '❌ Não configurado'}\n`;
    statusText += `- Senha PFX: ${envConfig.certificatePassword || '❌ Não configurado'}\n`;
    statusText += `- Thumbprint: ${envConfig.certificateThumbprint || '❌ Não configurado'}\n\n`;
  
    statusText += `🔗 **Conexão:**\n`;
    if (!this.pjeClient) {
      statusText += `- Status: ❌ Cliente não configurado\n`;
      statusText += `- Solução: Execute 'pje_configurar' primeiro\n\n`;
    } else {
      statusText += `- Status: ✅ Cliente configurado\n`;
      if ((this.pjeClient as any).accessToken) {
        statusText += `- Autenticação: ✅ Token ativo\n`;
      } else if ((this.pjeClient as any).certificateManager) {
        statusText += `- Autenticação: 🔐 Certificado configurado\n`;
      } else {
        statusText += `- Autenticação: ⚠️ Apenas consultas públicas\n`;
      }
    }
  
    statusText += `\n💡 **Próximos passos:**\n`;
    if (!envConfig.baseUrl) {
      statusText += `1. Configure PJE_BASE_URL no arquivo .env\n`;
    }
    if (!envConfig.certificatePath && !envConfig.ssoUrl) {
      statusText += `2. Configure certificado digital ou credenciais SSO no arquivo .env\n`;
    }
    if (!this.pjeClient) {
      statusText += `3. Execute: 'Configure o PJE'\n`;
    } else {
      statusText += `3. ✅ Pronto para usar!\n`;
    }
  
    return {
      content: [
        {
          type: "text",
          text: statusText,
        },
      ],
    };
  }

• src/index.ts:286-292 (schema)

  The tool schema definition including name, description, and empty input schema for 'pje_status'.

    name: "pje_status",
    description: "Verifica o status da configuração e conexão do PJE",
    inputSchema: {
      type: "object",
      properties: {},
    },
  },

• src/index.ts:346-347 (registration)

  The switch case that registers and routes calls to the 'pje_status' tool to its handler method.

  case "pje_status":
    return await this.verificarStatus();