Valeur Intrinsèque — MCP Server

Serveur Model Context Protocol qui permet à n'importe quelle IA (Claude, Cursor, ChatGPT…) d'analyser des actions en bourse via la méthode Benjamin Graham / value investing.

Outils disponibles

| Outil | Description | |-------|-------------| | analyze_stock | Analyse fondamentale complète (valeur intrinsèque, score Graham /10, 10 critères, métriques clés) | | get_intrinsic_value | Calcul rapide de la valeur intrinsèque + marge de sécurité | | get_financial_statements | États financiers sur 5 ans (compte de résultat, bilan, cash-flow) | | get_valuation_metrics | Historique de valorisation (P/E, P/B, PEG, EV/EBITDA) | | get_stock_price | Cours actuel d'une action | | get_price_history | Historique des cours (1 mois à 5 ans) | | get_moat_score | Score d'avantage concurrentiel (1-5) | | get_management_score | Score de qualité du management (1-5) | | screen_stocks | Screener : actions analysées classées par score | | compare_stocks | Comparaison côte à côte de 2 à 8 actions |

Mode 1 : Local (stdio) — pour développeurs

Installation

cd mcp-server
npm install

Utilisation avec Claude Desktop

Ajouter dans ~/Library/Application Support/Claude/claude_desktop_config.json :

{
  "mcpServers": {
    "valeur-intrinseque": {
      "command": "node",
      "args": ["/chemin/vers/valeur-intrinseque/mcp-server/index.js"],
      "env": {
        "VI_API_URL": "https://valeur-intrinseque.fr"
      }
    }
  }
}

Utilisation avec Cursor

Le fichier .cursor/mcp.json est déjà configuré dans le projet.

Mode 2 : Remote (HTTP) — pour tous les utilisateurs

Le serveur MCP est déployé sur https://mcp.valeur-intrinseque.fr/mcp et accessible à n'importe quelle IA sans installation.

Connexion depuis Claude Desktop

{
  "mcpServers": {
    "valeur-intrinseque": {
      "type": "streamable-http",
      "url": "https://mcp.valeur-intrinseque.fr/mcp",
      "headers": {
        "Authorization": "Bearer VOTRE_CLE_API"
      }
    }
  }
}

Connexion depuis Cursor

{
  "mcpServers": {
    "valeur-intrinseque": {
      "url": "https://mcp.valeur-intrinseque.fr/mcp",
      "headers": {
        "Authorization": "Bearer VOTRE_CLE_API"
      }
    }
  }
}

Connexion depuis n'importe quel client MCP

Endpoint:  https://mcp.valeur-intrinseque.fr/mcp
Transport: Streamable HTTP (POST/GET/DELETE)
Auth:      Authorization: Bearer <api_key>  OU  X-API-Key: <api_key>
Health:    GET https://mcp.valeur-intrinseque.fr/health

Configuration

| Variable | Défaut | Description | |----------|--------|-------------| | VI_API_URL | https://valeur-intrinseque.fr | URL de base de l'API backend | | MCP_PORT | 3013 | Port HTTP (mode remote) | | MCP_API_KEY | (vide = pas d'auth) | Clé API requise pour les connexions |

Démarrage en mode remote (développement)

MCP_PORT=3013 VI_API_URL=http://localhost:3004 node index.js --remote

Déploiement (Docker)

docker build -t valeur-intrinseque_mcp .
docker run -d \
  --name valeur-intrinseque_mcp \
  -p 3013:3013 \
  -e VI_API_URL=http://localhost:3004 \
  -e MCP_API_KEY=votre_cle_secrete \
  --restart always \
  valeur-intrinseque_mcp

Architecture

Toute IA compatible MCP
(Claude, Cursor, ChatGPT, Copilot…)
        │
        │  HTTPS (Streamable HTTP)
        ▼
┌──────────────────────────────┐
│  mcp.valeur-intrinseque.fr   │  ← Nginx reverse proxy (SSL)
│  (port 443)                  │
└──────────┬───────────────────┘
           │
           ▼
┌──────────────────────────────┐
│  MCP Server (Docker)         │  ← Ce serveur (port 3013)
│  Auth par clé API            │
│  10 outils d'analyse         │
└──────────┬───────────────────┘
           │  HTTP interne
           ▼
┌──────────────────────────────┐
│  graham-proxy (backend)      │  ← API existante (port 3004)
│  Graham analysis, Firestore  │
└──────────────────────────────┘

Exemples de prompts

• "Analyse Apple (AAPL) selon la méthode Graham"
• "Compare LVMH, Hermès et Kering"
• "Quelles actions ont le meilleur score dans le screener ?"
• "Donne-moi le bilan de Microsoft sur 5 ans"
• "L'action Total est-elle sous-évaluée ?"
• "Quel est le MOAT de Google ?"