Skip to main content
Glama
mkazimoto

TOTVS RM Database MCP Server

by mkazimoto
README.md
# TOTVS RM Database MCP Server — Windows Service

Instala e gerencia o [TOTVS RM Database MCP Server](C:\MCP\totvs-rm-database-mcp-server) como um **serviço Windows**, garantindo que ele seja iniciado automaticamente junto com o sistema operacional.

---

## Pré-requisitos

| Requisito | Versão mínima |
|---|---|
| Node.js | 18+ (testado com v24) |
| Sistema Operacional | Windows 10 / Server 2019+ |
| Permissão | **Administrador** |

O servidor MCP deve estar presente em:
```
C:\MCP\totvs-rm-database-mcp-server\
```

---

## Instalação das dependências

```powershell
cd c:\GIT\ExtrairRAG-BancoDados-WindowsService
npm install
```

---

## Instalar o serviço

> Execute o terminal **como Administrador**.

```powershell
node install-service.js
```

O serviço será registrado no Windows com as seguintes configurações:

| Propriedade | Valor |
|---|---|
| Nome | `TotvsRmDatabaseMcpServer` |
| Descrição | MCP Server HTTP para banco de dados TOTVS RM |
| Endpoint | `http://localhost:3000/mcp` |
| Inicialização | Automática |
| Variável `PORT` | `3000` |
| Variável `MCP_API_KEY` | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` |

---

## Remover o serviço

> Execute o terminal **como Administrador**.

```powershell
node uninstall-service.js
```

---

## Gerenciar o serviço manualmente

```powershell
# Verificar status
Get-Service -Name TotvsRmDatabaseMcpServer

# Iniciar
Start-Service -Name TotvsRmDatabaseMcpServer

# Parar
Stop-Service -Name TotvsRmDatabaseMcpServer

# Reiniciar
Restart-Service -Name TotvsRmDatabaseMcpServer
```

---

## Logs

Os logs do serviço são gerados pelo `node-windows` na pasta:

```
C:\MCP\totvs-rm-database-mcp-server\daemon\
```

Arquivos gerados:
- `TotvsRmDatabaseMcpServer.log` — saída padrão (stdout)
- `TotvsRmDatabaseMcpServer_error.log` — erros (stderr)

---

## Estrutura do projeto

```
ExtrairRAG-BancoDados-WindowsService\
├── install-service.js      # Registra e inicia o serviço Windows
├── uninstall-service.js    # Remove o serviço Windows
├── package.json
└── node_modules\
    └── node-windows\       # Biblioteca de integração com o SCM do Windows
```

---

## Autenticação no MCP Server

O servidor exige um **Bearer token** em todas as requisições ao endpoint `/mcp`:

Para alterar a chave, edite o arquivo `.env` em `C:\MCP\totvs-rm-database-mcp-server\.env` e reinicie o serviço.