you-mcp-server/README.md

MCP server for the You project - connects Claude to your personal data backend

# You MCP Server

Serveur MCP (Model Context Protocol) pour le projet You. Ce serveur permet à Claude d'accéder à vos données personnelles stockées dans votre backend You de manière sécurisée.

## 🎯 Objectif

Ce serveur MCP expose un seul outil `ask-question` qui permet à Claude de:
1. Recevoir une question de votre part
2. Transmettre cette question à votre backend You via une API sécurisée
3. Récupérer et retourner la réponse basée sur vos données personnelles

## 📋 Prérequis

- Node.js version 18 ou supérieure
- npm (inclus avec Node.js)
- Un token d'accès valide pour votre backend You
- Votre backend You déployé et accessible

## 🚀 Installation

### Installation globale (recommandée)

```bash
npm install -g you-mcp-server
```

### Installation locale

```bash
npm install you-mcp-server
```

### Installation depuis les sources

```bash
git clone https://github.com/yourusername/you-mcp-server.git
cd you-mcp-server
npm install
npm run build
```

## 💻 Utilisation

### Démarrage du serveur

```bash
npx you-mcp-server --access-token YOUR_ACCESS_TOKEN
```

### Options disponibles

- `--access-token, -t` (requis) : Token d'accès pour l'authentification au backend
- `--backend-url, -u` (optionnel) : URL personnalisée du backend (par défaut: `https://you-backend.mondomaine.com/ask`)

### Exemples

```bash
# Utilisation avec l'URL par défaut
npx you-mcp-server --access-token abc123xyz789

# Utilisation avec une URL personnalisée
npx you-mcp-server --access-token abc123xyz789 --backend-url https://mon-backend.example.com/api/ask
```

## 🔧 Configuration avec Claude

### 1. Configuration MCP dans Claude

Ajoutez cette configuration à votre fichier de configuration MCP de Claude:

```json
{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["you-mcp-server", "--access-token", "YOUR_ACCESS_TOKEN"]
    }
  }
}
```

### 2. Emplacement du fichier de configuration

Le fichier de configuration se trouve généralement à:
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`
- **Linux**: `~/.config/Claude/claude_desktop_config.json`

### 3. Redémarrage de Claude

Après avoir modifié la configuration, redémarrez Claude pour que les changements prennent effet.

## 🛠️ Outil disponible

### `ask-question`

**Description**: Pose une question au backend You et récupère la réponse basée sur vos données personnelles.

**Paramètres**:
- `question` (string, requis): La question à poser au backend You

**Exemple d'utilisation dans Claude**:
```
Peux-tu me dire quels sont mes rendez-vous de demain ?
```

Claude utilisera automatiquement l'outil `ask-question` pour récupérer cette information depuis votre backend.

## 🔒 Sécurité

- **Token d'accès**: Le serveur utilise un token Bearer pour s'authentifier auprès de votre backend
- **HTTPS**: Toutes les communications avec le backend utilisent HTTPS
- **Logs**: Les requêtes sont loggées pour le débogage (sans exposer le token)
- **Timeout**: Les requêtes vers le backend ont un timeout de 30 secondes

## 📝 Format des données

### Requête vers le backend

```json
{
  "question": "Votre question ici"
}
```

### Headers envoyés

```
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
```

### Réponse attendue du backend

```json
{
  "answer": "La réponse à votre question"
}
```

## 🐛 Dépannage

### Erreurs courantes

1. **"Token d'accès requis"**
   - Assurez-vous de fournir le paramètre `--access-token`

2. **"Pas de réponse du backend"**
   - Vérifiez votre connexion internet
   - Vérifiez que l'URL du backend est correcte
   - Vérifiez que votre backend est en ligne

3. **"Erreur 401 Unauthorized"**
   - Vérifiez que votre token d'accès est valide
   - Vérifiez que le token n'a pas expiré

4. **"Erreur 404 Not Found"**
   - Vérifiez l'URL de votre backend avec `--backend-url`

### Logs et débogage

Le serveur affiche des logs détaillés pour vous aider à diagnostiquer les problèmes:

```
[INFO] Démarrage du serveur MCP You...
[INFO] Token d'accès configuré, backend: https://you-backend.mondomaine.com/ask
[INFO] Serveur MCP You démarré et connecté via stdio
[INFO] En attente des requêtes de Claude...
[INFO] Question reçue de Claude: "Quels sont mes rendez-vous ?"
[INFO] Envoi de la question au backend: https://you-backend.mondomaine.com/ask
[INFO] Réponse reçue du backend avec succès
```

## 🔄 Développement

### Scripts disponibles

```bash
npm run build    # Compile TypeScript vers JavaScript
npm run dev      # Lance en mode développement avec ts-node
npm start        # Lance la version compilée
```

### Structure du projet

```
you-mcp-server/
├── src/
│   └── index.ts         # Code source principal
├── dist/                # Code compilé (généré)
├── package.json         # Configuration npm
├── tsconfig.json        # Configuration TypeScript
└── README.md            # Cette documentation
```

## 📄 Licence

MIT License - voir le fichier LICENSE pour plus de détails.

## 🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à ouvrir une issue ou une pull request.

## 📞 Support

Si vous rencontrez des problèmes, veuillez:
1. Vérifier cette documentation
2. Consulter les logs du serveur
3. Ouvrir une issue sur GitHub avec les détails de votre problème