WhytcardAI/WhytCard-Intelligence
3.2
If you are the rightful owner of WhytCard-Intelligence and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
WhytCard Intelligence is an MCP server providing persistent memory and contextual cognition to GitHub Copilot.
Tools
7
Resources
0
Prompts
0
WhytCard Intelligence v2.0
MCP Server for GitHub Copilot - Systeme CORTEX de memoire cognitive avancee
Nouveautes v2.0
Ameliorations Majeures
| Feature | Description |
|---|---|
| Exceptions Typees | Hierarchie d'exceptions specifiques pour meilleur debugging |
| Cache Embeddings | Cache LRU pour embeddings frequents (10x plus rapide) |
| Batch Processing | Embeddings groupes pour stockage massif |
| Index FTS5 | Recherche full-text ultra-rapide dans SQLite |
| Connection Pool | Pool de connexions SQLite reutilisables |
| Validation Pydantic | Validation stricte des entrees |
| Logging Structure | Logs JSON pour analyse |
Nouveaux Outils MCP
| Outil | Description |
|---|---|
cortex_search | Recherche hybride (vectorielle + full-text) |
cortex_context | Gestion de contexte de conversation |
cortex_cleanup | Maintenance et nettoyage automatique |
cortex_tag | Systeme de tags pour organisation |
cortex_export | Export de la memoire en JSON |
cortex_import | Import depuis un export |
cortex_relate | Relations entre connaissances |
Architecture CORTEX v2
┌─────────────────────────────────────────────────────────────┐
│ CORTEX ENGINE v2 │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ PERCEIVE │───▶│ EXECUTE │───▶│ LEARN │ │
│ │ │ │ │ │ │ │
│ │ Analyze │ │ Decide │ │ Memorize │ │
│ │ Context │ │ Actions │ │ Patterns │ │
│ └──────────┘ └──────────┘ └──────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ TRIPLE MEMORY v2 │ │
│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │
│ │ │ Semantic │ │ Episodic │ │Procedural │ │ │
│ │ │ (LanceDB) │ │ (SQLite) │ │ (YAML) │ │ │
│ │ │ + Cache │ │ + FTS5 │ │ + Tags │ │ │
│ │ └───────────┘ └───────────┘ └───────────┘ │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ NEW: KNOWLEDGE GRAPH │ │
│ │ Relations entre connaissances │ │
│ └─────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
Installation
1. Dependances
cd WhytCard-intelligence
pip install -r requirements.txt
2. Configuration VS Code
Ajouter dans .vscode/settings.json :
{
"github.copilot.chat.mcp.servers": {
"whytcard-intelligence": {
"command": "python",
"args": ["-c", "from src.mcp_server import main; main()"],
"cwd": "C:/Whytcard_Workspace/WhytCard_Project/WhytCard-intelligence",
"env": {
"PYTHONPATH": "C:/Whytcard_Workspace/WhytCard_Project/WhytCard-intelligence"
}
}
}
}
Structure du Projet
WhytCard-intelligence/
├── README.md
├── requirements.txt
├── pytest.ini
│
├── src/
│ ├── __init__.py
│ ├── mcp_server.py # Point d'entree MCP (12 outils)
│ │
│ ├── config/
│ │ ├── __init__.py
│ │ ├── settings.py # Configuration Pydantic
│ │ └── constants.py # Constantes centralisees
│ │
│ ├── core/
│ │ ├── __init__.py
│ │ ├── cortex_engine.py # Orchestrateur principal
│ │ ├── perceiver.py # Phase PERCEIVE
│ │ ├── executor.py # Phase EXECUTE
│ │ ├── learner.py # Phase LEARN
│ │ └── context_manager.py # NEW: Gestion contexte
│ │
│ ├── memory/
│ │ ├── __init__.py
│ │ ├── semantic_memory.py # LanceDB + Cache
│ │ ├── episodic_memory.py # SQLite + FTS5 + Pool
│ │ ├── procedural_memory.py # YAML + Tags
│ │ └── knowledge_graph.py # NEW: Relations
│ │
│ └── exceptions/
│ ├── __init__.py
│ └── cortex_exceptions.py # Exceptions typees
│
├── tests/
│ └── ...
│
├── docs/
│ ├── INDEX.md
│ ├── INTERDICTIONS.md
│ └── ...
│
└── data/ # Runtime (auto-genere)
├── semantic/
├── episodic.db
├── procedural/
└── exports/
12 Outils MCP
Outils Originaux (ameliores)
| Outil | Description |
|---|---|
cortex_init | Initialise le systeme avec options avancees |
cortex_process | Pipeline CORTEX complet |
cortex_query | Recherche dans les memoires |
cortex_store | Stockage avec tags et relations |
cortex_learn | Apprentissage force |
cortex_feedback | Feedback utilisateur |
cortex_stats | Statistiques etendues |
Nouveaux Outils
| Outil | Description |
|---|---|
cortex_search | Recherche hybride avancee |
cortex_context | Gestion de contexte |
cortex_cleanup | Maintenance automatique |
cortex_tag | Gestion des tags |
cortex_export | Export/Import memoire |
Tests
# Tous les tests
python -m pytest tests/ -v
# Avec coverage
python -m pytest tests/ --cov=src --cov-report=html
Stack Technique
| Composant | Version | Usage |
|---|---|---|
| Python | >= 3.11 | Runtime async natif |
| LanceDB | >= 0.6.0 | Vector database |
| FastEmbed | >= 0.2.0 | Embeddings locaux ONNX |
| aiosqlite | >= 0.19.0 | SQLite async |
| Pydantic | >= 2.0 | Validation |
| PyYAML | >= 6.0 | Patterns proceduraux |
| MCP SDK | >= 0.9.0 | Model Context Protocol |
Licence
MIT - WhytCard AI 2025