convez.ai
MCP ServerIntegração & APIsIntermediário
GueuAlex

Kbine MCP Server

GueuAlex/kbine-mcp-server

Consulte base Kbine direto no Claude com relatórios e diagnósticos

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe uma base de dados Kbine em modo leitura via Claude Desktop/Mobile. Fornece ferramentas de relatórios (mensais, diários, períodos), diagnósticos (pagamentos, pedidos) e consultas SQL personalizadas, permitindo que usuários gerem relatórios autonomamente sem intervenção técnica.

Instalação

$npx convez-ai GueuAlex/kbine-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerar relatórios operacionais mensais e diários autonomamente
  • Diagnosticar pagamentos bloqueados e históricos de clientes
  • Executar consultas SQL personalizadas na base de dados Kbine
  • Analisar evolução de receita e desempenho de operadores

Veredito

MCP server bem estruturado para acesso seguro a dados Kbine via Claude. Implementa corretamente validação, restrições de permissão e limite de resultados, mas requer base de dados existente e configuração manual — ideal para contextos empresariais com infraestrutura estabelecida.

README

A tradução para o português deste README ainda está na fila.

Kbine MCP Server

Serveur MCP (Model Context Protocol) pour interroger la base de donnees Kbine en lecture seule via Claude Desktop ou Claude Mobile.

Objectif

Permettre au client (M. Emmanuel) de generer ses propres rapports de maniere autonome, sans intervention technique. Le serveur expose des outils de reporting et de diagnostic accessibles directement depuis Claude.

Outils disponibles

Rapports

OutilDescription
rapport_mensuelBilan mensuel par operateur et par plan
rapport_journalierBilan d'une journee avec plage horaire optionnelle
rapport_periodeBilan entre deux dates
stats_operateursRepartition par operateur
top_plansClassement des plans les plus vendus
evolution_caEvolution du chiffre d'affaires

Diagnostics

OutilDescription
paiements_pendingListe des paiements bloques
paiement_clientHistorique d'un client specifique
statut_commandeDetail complet d'une commande

Requetes personnalisees

OutilDescription
requete_sqlExecute une requete SELECT personnalisee
aide_schemaAffiche la documentation des tables

Installation

Prerequis

  • Node.js >= 18.x
  • Docker et Docker Compose (pour le developpement local)

Developpement local

# Cloner le repository
git clone https://github.com/GueuAlex/kbine-mcp-server.git
cd kbine-mcp-server

# Installer les dependances
npm install

# Demarrer avec Docker (base de donnees incluse)
docker compose up -d

# Ou demarrer en mode developpement (necessite une BDD externe)
cp .env.example .env
# Editer .env avec vos credentials
npm run dev

Production

# Sur le serveur
cd /var/www
git clone https://github.com/GueuAlex/kbine-mcp-server.git
cd kbine-mcp-server

# Configurer l'environnement
cp .env.example .env
nano .env  # Remplir avec les vrais credentials

# Builder et demarrer
docker compose -f docker-compose.prod.yml up -d --build

Configuration Claude Desktop

Ajouter dans claude_desktop_config.json:

{
  "mcpServers": {
    "kbine-reports": {
      "url": "https://mcp.kbine-mobile.com/sse",
      "transport": "sse"
    }
  }
}

Securite

  • L'utilisateur MySQL (kbine_readonly) n'a que des droits SELECT
  • Les requetes sont validees et les mots-cles dangereux sont bloques
  • Les donnees sensibles (mots de passe, tokens) ne sont pas exposees
  • Une limite de resultats est appliquee automatiquement

Structure du projet

kbine-mcp-server/
├── src/
│   ├── index.ts           # Point d'entree avec Express + SSE
│   ├── database/
│   │   └── connection.ts  # Pool MySQL et helpers
│   ├── tools/
│   │   ├── index.ts       # Export des outils
│   │   ├── reports.ts     # Outils de rapports
│   │   ├── diagnostics.ts # Outils de diagnostic
│   │   └── queries.ts     # Requetes personnalisees
│   └── utils/
│       └── formatters.ts  # Formatage des resultats
├── scripts/
│   └── init-dev-db.sql    # Script d'init pour dev
├── Dockerfile
├── docker-compose.yml     # Dev local
├── docker-compose.prod.yml # Production
└── README.md

Endpoints HTTP

EndpointMethodeDescription
/healthGETHealth check
/sseGETConnexion SSE pour MCP
/messagesPOSTReception des messages MCP

Licence

Projet prive - Tous droits reserves

Ver o original no GitHub

Bom para

Relacionados