Ce guide explique comment connecter oview avec Claude Code via le Model Context Protocol (MCP).
-
oview installé et configuré
oview install # Infrastructure globale cd /path/to/project oview init # Initialisation du projet oview up # Base de données oview index # Indexation du code
-
Claude Code installé
- Suivez les instructions sur claude.ai/code
cd /home/david/Documents/oview
go build -o oview .
sudo cp oview /usr/local/bin/oviewAjoutez le serveur MCP à la configuration de Claude Code:
Fichier: ~/.claude/mcp_servers.json
{
"oview": {
"command": "oview",
"args": ["mcp"],
"description": "oview RAG system for semantic code search",
"autoApprove": ["search", "get_context", "project_info"]
}
}Note: Remplacez le chemin si oview n'est pas dans /usr/local/bin/
# Test manuel du MCP server
cd /path/to/your/project
oview mcp
# Le serveur attend des commandes JSON-RPC sur stdin
# Ctrl+C pour quitterRedémarrez Claude Code pour qu'il charge le nouveau serveur MCP.
Une fois configuré, Claude Code aura accès à trois outils:
Claude peut rechercher dans votre codebase:
Utilisateur: "Où est implémentée l'authentification ?"
Claude: [utilise search("authentication logic")]
Claude peut obtenir du contexte avant de modifier du code:
Utilisateur: "Modifie src/Controller/UserController.php"
Claude: [utilise get_context("src/Controller/UserController.php")]
[comprend le contexte]
[propose les modifications]
Claude peut voir la configuration du projet:
Utilisateur: "Quel est le stack de ce projet ?"
Claude: [utilise project_info()]
Ce projet utilise...
Utilisateur: Comment fonctionne le système de cache dans ce projet ?
Claude Code:
1. [Utilise search("cache system implementation")]
2. Trouve 5 chunks pertinents dans:
- src/Service/CacheManager.php
- config/packages/cache.yaml
- src/EventListener/CacheListener.php
3. Analyse le code
4. Explique le système de cache
"Le système de cache utilise Redis avec une stratégie de TTL..."
# Vérifier que oview est accessible
which oview
# Vérifier la configuration du projet
cd /path/to/project
cat .oview/project.yaml
# Tester manuellement
oview mcp- Vérifier
~/.claude/mcp_servers.json - Redémarrer Claude Code
- Vérifier les logs Claude Code
# Vérifier que PostgreSQL tourne
docker ps | grep oview-postgres
# Vérifier la base du projet
docker exec oview-postgres psql -U oview -l | grep oview_Pour Ollama:
# Vérifier Ollama
ollama list
# Relancer si nécessaire
ollama serve &Pour OpenAI:
# Vérifier la clé API
echo $OPENAI_API_KEY
# Ou dans .oview/project.yaml
grep api_key .oview/project.yamlDans votre workflow, vous pouvez demander à Claude:
"Recherche les 10 meilleurs exemples d'API REST dans le projet"
Claude utilisera automatiquement search("API REST examples", limit=10)
Modifiez .oview/rag.yaml pour inclure plus de fichiers:
indexing:
include_paths:
- src/
- config/
- templates/
- docs/ # Ajouter la documentation
- scripts/ # Ajouter les scriptsPuis ré-indexez:
oview index- Données locales: Tout reste sur votre machine
- Pas de télémétrie: oview ne communique pas avec des serveurs externes
- Embeddings locaux: Utilisez Ollama pour un système 100% local
- Clés API: Si vous utilisez OpenAI, les clés sont dans
~/.bashrcou.oview/project.yaml(ne pas commit!)
# Voir les statistiques
docker exec oview-postgres psql -U oview -d oview_yourproject -c "
SELECT
COUNT(*) as chunks,
pg_size_pretty(pg_total_relation_size('chunks')) as size
FROM chunks;
"- Recherche sémantique: ~50-200ms (dépend de l'index HNSW)
- Génération d'embeddings:
- Ollama local: ~100-500ms
- OpenAI API: ~200-1000ms
- Auto-refresh: Ré-indexer automatiquement après un commit
- Cache embeddings: Mettre en cache les requêtes fréquentes
- Multi-projets: Rechercher dans plusieurs projets simultanément
- Filtres avancés: Filtrer par langage, type, date, etc.
Problème ou question ? Ouvrez une issue sur GitHub!