GuidesMCP
Tuto : créer un serveur MCP en TypeScript
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.