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.
This server cannot be deployed
Maintenance
ActivityStale
ResponsivenessNo issues