mcp-teletubbies 🧸📈

Serveur MCP (Model Context Protocol) qui branche Claude (Desktop, Claude Code, ou tout client MCP) sur votre Teletubbies Trading Hub (trading Hyperliquid).

Claude peut alors lire votre portefeuille, vos positions et stratégies, lancer des backtests et concevoir de nouvelles stratégies — directement dans votre hub, en langage naturel.

🔒 Sans risque par conception : ce serveur n'expose aucun ordre live ni activation de stratégie. Les stratégies créées le sont en mode paper et désactivées ; vous gardez la main pour les lancer depuis l'interface.

Installation

Aucune installation manuelle : votre client MCP lance le serveur via npx.

Configuration

Recommandé — par token. Dans le hub, ouvrez 👤 Mon compte → Connexion Claude (MCP) et générez un token. La page affiche directement la config prête à copier (Claude Code ou Desktop). Le token est révocable à tout moment et n'expose pas votre mot de passe.

| Variable | Description | Exemple | | ----------- | ------------------------------------------------- | ---------------------------- | | HUB_URL | URL de votre hub | https://teletubbies.online | | HUB_TOKEN | token généré dans « Mon compte » | ttb_… |

À défaut de token, l'authentification par mot de passe reste possible avec HUB_USERNAME + HUB_PASSWORD (au lieu de HUB_TOKEN).

Claude Desktop

Dans claude_desktop_config.json (menu Settings → Developer → Edit Config) :

{
  "mcpServers": {
    "teletubbies": {
      "command": "npx",
      "args": ["-y", "mcp-teletubbies"],
      "env": {
        "HUB_URL": "https://teletubbies.online",
        "HUB_TOKEN": "ttb_votre_token"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add teletubbies \
  -e HUB_URL=https://teletubbies.online \
  -e HUB_TOKEN=ttb_votre_token \
  -- npx -y mcp-teletubbies

Redémarrez le client : les outils Teletubbies apparaissent.

Outils exposés

Lecture

• get_summary — équité, PnL, état du wallet
• get_portfolio — historique d'équité
• get_fills — derniers trades
• get_log — journal d'exécutions
• get_tubbies — stratégies actives + copy trading
• get_settings — réseau + adresse suivie
• list_strategies / get_strategy — les bots à blocs
• list_backtests / get_backtest — backtests sauvegardés

Backtest

• run_backtest — rejoue une stratégie sur l'historique (frais, funding, slippage réalistes)

Création (mode paper)

• create_strategy — crée une stratégie de blocs, en paper et désactivée

Exemples de prompts

• « Montre-moi le PnL et les positions ouvertes de mon hub. »
• « Backteste la stratégie alt_div_offensif sur 180 jours et résume les métriques. »
• « Conçois une stratégie qui achète BTC quand le RSI 1h passe sous 30 et arme un stop-loss à 3 %, puis crée-la dans mon hub. »

Sécurité

• Communication directe avec votre hub (HTTPS), authentifiée par session.
• Aucune opération live ni activation de stratégie via ce serveur.
• Vos identifiants restent dans la config locale de votre client MCP.

Licence

MIT