Projuris MCP Server

Servidor Model Context Protocol (MCP) para consulta dinâmica de dados do ERP Projuris, construído com mcp-framework. Esta ferramenta permite que assistentes AI como o Claude realizem consultas em linguagem natural ao ERP Projuris.

📋 Descrição

Este servidor MCP implementa uma interface que permite realizar consultas em linguagem natural ao ERP Projuris, gerando relatórios e insights. A ferramenta principal ConsultaProjurisTool conecta-se à API do Projuris para processar consultas e retornar os resultados em formato markdown, HTML ou texto.

🚀 Início Rápido

# Instalar dependências
npm install

# Compilar o projeto
npm run build

# Executar o servidor
npm start

🧩 Estrutura do Projeto

projuris-mcp-server/
├── src/
│   ├── tools/               # Ferramentas MCP
│   │   └── ConsultaprojurisTool.ts
│   └── index.ts             # Ponto de entrada do servidor
├── package.json
└── tsconfig.json

🔧 Configuração

O servidor utiliza as seguintes configurações padrão para conectar à API Projuris:

{
  apiUrl: "http://localhost:8080",  // URL base da API Projuris
  tenant: "consultivo",             // Tenant (contexto) do Projuris
  format: "markdown"                // Formato de saída (markdown, html, texto)
}

🛠️ Como Usar a Ferramenta de Consulta

A ferramenta ConsultaProjurisTool permite realizar consultas em linguagem natural ao ERP Projuris:

// Exemplo de utilização:
const resposta = await consultaProjuris({
  pergunta: "Quais são os processos ativos no último mês?"
});

📱 Uso com o Claude Desktop

Desenvolvimento Local

Adicione esta configuração ao arquivo de configuração do Claude Desktop:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

Isto é para rodar LOCAL com o código fonte do server MCP:

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

Após Publicação

Após publicar o pacote no npm, utilize:

{
  "mcpServers": {
    "projuris-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "projuris-mcp-server"
      ],
      "env": {
        "PROJURIS_TENANT_ID": "consultivo",
        "PROJURIS_API_URL": "http://localhost:8080"
      }
    }
  }
}

🔄 Construção e Testes

1. Faça alterações nas ferramentas
2. Execute npm run build para compilar
3. O servidor carregará automaticamente suas ferramentas na inicialização

📚 Implementação

A ferramenta ConsultaProjurisTool implementa:

• Consultas através de requisições HTTP à API do Projuris
• Tratamento de erros apropriado
• Configuração de headers específicos, incluindo tenant e formato de saída
• Logging detalhado para auxiliar na depuração

🌐 Referências

• MCP Framework GitHub
• MCP Framework Docs
• Claude AI