WhytCard-Intelligence

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

FeatureDescription
Exceptions TypeesHierarchie d'exceptions specifiques pour meilleur debugging
Cache EmbeddingsCache LRU pour embeddings frequents (10x plus rapide)
Batch ProcessingEmbeddings groupes pour stockage massif
Index FTS5Recherche full-text ultra-rapide dans SQLite
Connection PoolPool de connexions SQLite reutilisables
Validation PydanticValidation stricte des entrees
Logging StructureLogs JSON pour analyse

Nouveaux Outils MCP

OutilDescription
cortex_searchRecherche hybride (vectorielle + full-text)
cortex_contextGestion de contexte de conversation
cortex_cleanupMaintenance et nettoyage automatique
cortex_tagSysteme de tags pour organisation
cortex_exportExport de la memoire en JSON
cortex_importImport depuis un export
cortex_relateRelations 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)

OutilDescription
cortex_initInitialise le systeme avec options avancees
cortex_processPipeline CORTEX complet
cortex_queryRecherche dans les memoires
cortex_storeStockage avec tags et relations
cortex_learnApprentissage force
cortex_feedbackFeedback utilisateur
cortex_statsStatistiques etendues

Nouveaux Outils

OutilDescription
cortex_searchRecherche hybride avancee
cortex_contextGestion de contexte
cortex_cleanupMaintenance automatique
cortex_tagGestion des tags
cortex_exportExport/Import memoire

Tests

# Tous les tests
python -m pytest tests/ -v

# Avec coverage
python -m pytest tests/ --cov=src --cov-report=html

Stack Technique

ComposantVersionUsage
Python>= 3.11Runtime async natif
LanceDB>= 0.6.0Vector database
FastEmbed>= 0.2.0Embeddings locaux ONNX
aiosqlite>= 0.19.0SQLite async
Pydantic>= 2.0Validation
PyYAML>= 6.0Patterns proceduraux
MCP SDK>= 0.9.0Model Context Protocol

Licence

MIT - WhytCard AI 2025