Démarrage rapide

Il vous faut Node 22.18 ou plus récent (il exécute directement les fichiers TypeScript), Bun ou Deno.

Générer un projet#

npx picomcp init my-server
cd my-server
npm install

Vous obtenez un serveur prêt à tourner :

Vous préférez partir de zéro ? Installez les deux paquets et écrivez server.ts vous-même :

npm install picomcp zod

Écrire un outil#

Ouvrez server.ts :

import { pico } from "picomcp";
import { z } from "zod";

export const server = pico({ name: "my-server", version: "0.1.0" })
  .tool("greet", {
    description: "Greets someone by name.",
    input: z.object({ name: z.string().describe("Who to greet") }),
    run: ({ name }) => `Hello, ${name}!`,
  });

• description est ce que le modèle lit pour décider quand appeler l’outil. Écrivez-la pour le modèle.
• input accepte n’importe quel Standard Schema. Dans run, name est typé string.
• Ici, run renvoie une chaîne. Il peut aussi renvoyer des objets, des blocs de contenu, ou lever une erreur : voir Outils.

Le tester#

import assert from "node:assert/strict";
import { test } from "node:test";
import { server } from "./server.ts";

test("greet says hello", async () => {
  const result = await server.call("greet", { name: "Ada" });
  assert.deepEqual(result.content, [{ type: "text", text: "Hello, Ada!" }]);
});

npm test

server.call est vérifié au typage : une faute dans le nom de l’outil ou un argument manquant ne compile pas.

Le connecter#

Pour Claude Code :

claude mcp add my-server -- node /absolute/path/to/my-server/main.ts

Demandez ensuite à Claude de saluer quelqu’un. Pour Claude Desktop, Cursor, VS Code et les autres, voir Connecter un client.

L’inspecter#

MCP Inspector permet d’appeler les outils à la main et de voir les messages bruts :

npx @modelcontextprotocol/inspector node main.ts