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)

npm install -g you-mcp-server

Installation locale

npm install you-mcp-server

Installation depuis les sources

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

💻 Utilisation

Démarrage du serveur

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

# 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:

{
  "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

{
  "question": "Votre question ici"
}

Headers envoyés

Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

Réponse attendue du backend

{
  "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

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