GuidesMCP

Tuto : créer un serveur MCP en TypeScript

Par l’équipe Banzai LabsMis à jour le 2 min de lecture

server.tsMCPchercher_clientcréer_devislire_stockClaudeVos outils, décrits une fois, utilisables par l’IA
Un serveur MCP en TypeScript décrit vos outils ; Claude les appelle quand il en a besoin.

1. Installer

mkdir mcp-stock && cd mcp-stock
npm init -y
npm install @modelcontextprotocol/sdk zod
npm install -D typescript @types/node

Dans package.json, ajoutez "type": "module".

2. Le serveur

// src/index.ts
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { z } from 'zod';

const server = new McpServer({ name: 'stock', version: '1.0.0' });

server.registerTool(
  'lire_stock',
  {
    description: 'Renvoie le stock disponible d’un produit à partir de sa référence.',
    inputSchema: { reference: z.string().describe('Référence produit, ex. TSH-042') },
  },
  async ({ reference }) => {
    const qte = await lireStock(reference); // votre base ou votre API
    return { content: [{ type: 'text', text: `${reference} : ${qte} en stock` }] };
  },
);

await server.connect(new StdioServerTransport());

3. Les bonnes pratiques

  • Une description préciseC’est elle que lit l’IA pour choisir l’outil.
  • Des paramètres typésLe schéma Zod refuse les entrées invalides.
  • Les journaux sur stderrEn stdio, la sortie standard est réservée au protocole.
  • Des droits limitésLecture seule tant que ça suffit.

4. Compiler et brancher

npx tsc produit build/index.js. Pour le voir dans Claude : connecter un serveur MCP à Claude Desktop. Le principe : le serveur MCP.

Questions fréquentes

Quelle différence avec une API classique ?
Le serveur MCP décrit ses outils dans un format standard que les clients IA savent lire. Un même serveur sert Claude Desktop, Claude Code ou un agent maison.
Où tourne le serveur ?
En local, lancé par le client (transport stdio), ou sur un serveur distant joint en HTTP. On commence en local.
Comment sécuriser les outils ?
Un outil n’accède qu’à ce dont il a besoin, avec un compte aux droits limités. Les actions qui modifient (paiement, suppression) demandent une confirmation.

À lire ensuite

Tous les guides