AliceLynxx/QlikSense-MCP-server

QlikSense MCP Server

Een Model Context Protocol (MCP) server voor QlikSense applicaties die een gestandaardiseerde interface biedt voor het communiceren met QlikSense via MCP-compatibele tools.

📋 Overzicht

Deze MCP server maakt het mogelijk om QlikSense functionaliteit te integreren in moderne development workflows en AI-assistenten door een gestandaardiseerde interface te bieden voor:

• Apps beheer: Lijst van beschikbare QlikSense applicaties ophalen
• Taken monitoring: Overzicht en status van QlikSense taken
• Logs analyse: Toegang tot taak logs voor troubleshooting

🎯 Doelgroep

• Ontwikkelaars die QlikSense willen integreren met MCP-compatibele tools
• Data analisten die QlikSense functionaliteit willen automatiseren
• DevOps teams die QlikSense monitoring willen implementeren

✨ Functionaliteiten

Must-have Features

• ✅ Basis project setup met configuratie
• 🔄 QlikSense client implementatie (in ontwikkeling)
• 🔄 FastMCP server setup (in ontwikkeling)
• 🔄 Apps lijst tool (in ontwikkeling)
• 🔄 Taken lijst tool (in ontwikkeling)
• 🔄 Logs uitlezen tool (in ontwikkeling)

Nice-to-have Features

• 🔄 Error handling en logging
• 🔄 Configuratie validatie
• 🔄 Uitgebreide documentatie

🚀 Installatie

Vereisten

• Python 3.8 of hoger
• Toegang tot een QlikSense server
• Geldige QlikSense gebruikersaccount

Stap 1: Repository klonen

git clone https://github.com/AliceLynxx/QlikSense-MCP-server.git
cd QlikSense-MCP-server

Stap 2: Virtual environment aanmaken (aanbevolen)

python -m venv venv
source venv/bin/activate  # Op Windows: venv\\Scripts\\activate

Stap 3: Dependencies installeren

pip install -r requirements.txt

Stap 4: Configuratie instellen

1. Kopieer het voorbeeld configuratiebestand:

cp .env-example .env

2. Bewerk .env met jouw QlikSense server details:

# Verplichte configuratie
QLIK_SERVER=https://your-qlik-server.com
QLIK_USER=your-username
QLIK_PASSWORD=your-password

# Optionele configuratie
APP_ID=your-default-app-id
MCP_PORT=8080
LOG_LEVEL=INFO

⚙️ Configuratie

Environment Variabelen

*Gebruik QLIK_PASSWORD OF QLIK_API_KEY

Authenticatie Opties

1. Username/Password Authenticatie

QLIK_USER=your-username
QLIK_PASSWORD=your-password

2. API Key Authenticatie (indien ondersteund)

QLIK_API_KEY=your-api-key

🏃‍♂️ Gebruik

Server starten

python app.py

De MCP server start op http://localhost:8080 (of de geconfigureerde host/poort).

Beschikbare Tools

Opmerking: Tools zijn momenteel in ontwikkeling

1. list_apps: Lijst van beschikbare QlikSense applicaties
2. list_tasks: Overzicht van QlikSense taken
3. get_task_logs: Logs van specifieke taken ophalen

🏗️ Architectuur

QlikSense-MCP-server/
├── app.py              # Hoofdmodule met FastMCP server
├── qlik_client.py      # QlikSense API client
├── requirements.txt    # Python dependencies
├── .env-example       # Configuratie template
├── .env              # Lokale configuratie (niet in git)
└── README.md         # Deze documentatie

Module Overzicht

• app.py: FastMCP server setup en tool registratie
• qlik_client.py: QlikSense API client met session authenticatie
• requirements.txt: Alle benodigde Python packages
• .env-example: Template voor configuratie

🔧 Ontwikkeling

Development Setup

1. Clone de repository
2. Installeer development dependencies:

pip install -r requirements.txt

3. Run tests:

pytest

4. Code formatting:

black .
flake8 .

Project Status

Dit project is momenteel in actieve ontwikkeling. Zie project_stappen.txt voor de huidige roadmap en voortgang.

🤝 Bijdragen

Bijdragen zijn welkom! Zie de issues voor huidige ontwikkeltaken of maak een nieuwe issue aan voor feature requests of bug reports.

📝 Licentie

Dit project is gelicenseerd onder de MIT License.

🆘 Support

Voor vragen of problemen:

1. Check de Issues
2. Maak een nieuwe issue aan met gedetailleerde informatie
3. Controleer de configuratie volgens deze documentatie

🔗 Links

• Model Context Protocol (MCP) Documentatie
• QlikSense API Documentatie
• FastMCP Framework

Status: 🚧 In ontwikkeling - Basis project setup voltooid