Le MCP, de A à Z. Comment un assistant IA se branche sur vos données, et comment en écrire un.

→ {"jsonrpc":"2.0","id":1,"method":"initialize","params":{
     "protocolVersion":"2025-06-18","capabilities":{},
     "clientInfo":{"name":"claude-code","version":"1.0"}}}

← {"jsonrpc":"2.0","id":1,"result":{
     "protocolVersion":"2025-06-18",
     "capabilities":{"tools":{"listChanged":false}},
     "serverInfo":{"name":"paypedia","version":"1.0.0"}}}

→ {"jsonrpc":"2.0","method":"notifications/initialized"}      ← pas d'id : AUCUNE réponse

→ {"jsonrpc":"2.0","id":2,"method":"tools/list"}
← {"jsonrpc":"2.0","id":2,"result":{"tools":[
     {"name":"iban_check","description":"Valide un ou plusieurs IBAN…",
      "inputSchema":{"type":"object","properties":{"input":{"type":"string"}},
                     "required":["input"],"additionalProperties":false}} ]}}

→ {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{
     "name":"iban_check","arguments":{"input":"FR7630006000011234567890189"}}}
← {"jsonrpc":"2.0","id":3,"result":{
     "content":[{"type":"text","text":"## FR76 3000 6000 …\n**VALIDE** · France (FR)…"}],
     "isError":false}}

{
  name: 'bank_resolve',                       // identifiant stable, snake_case
  title: 'Résoudre un code banque',           // libellé lisible (facultatif)
  description:
    "Donne le nom et le BIC d'une banque à partir de son code banque national (celui " +
    "embarqué dans l'IBAN) et du pays. Registre de ~22 900 codes dans 44 pays. " +
    "À appeler quand on a un code banque (ex 30004 en France) sans savoir de quel " +
    "établissement il s'agit.",                // ← c'est ELLE qui déclenche l'appel
  inputSchema: {
    type: 'object',
    properties: {
      country:  { type: 'string', maxLength: 8,  description: 'Code pays ISO 3166-1 alpha-2, ex "FR", "DE", "ES".' },
      bankCode: { type: 'string', maxLength: 16, description: 'Code banque national, ex "30004".' },
    },
    required: ['country', 'bankCode'],
    additionalProperties: false,
  },
  run: async (args) => '…le texte remis au modèle…',
}

const TOOLS = [{
  name: 'somme',
  description: 'Additionne deux nombres. À appeler pour tout calcul de somme.',
  inputSchema: { type: 'object', properties: { a: { type: 'number' }, b: { type: 'number' } },
                 required: ['a', 'b'], additionalProperties: false },
  run: ({ a, b }) => `${a} + ${b} = ${Number(a) + Number(b)}`,
}]

const send = (m) => process.stdout.write(JSON.stringify(m) + '\n')   // stdout = protocole
const log  = (m) => process.stderr.write(m + '\n')                   // stderr = logs

let buf = ''
process.stdin.setEncoding('utf8')
process.stdin.on('data', (chunk) => {
  buf += chunk
  let nl
  while ((nl = buf.indexOf('\n')) >= 0) {
    const line = buf.slice(0, nl).trim(); buf = buf.slice(nl + 1)
    if (!line) continue
    let msg
    try { msg = JSON.parse(line) } catch { send({ jsonrpc: '2.0', id: null,
      error: { code: -32700, message: 'JSON invalide' } }); continue }
    if (!msg || typeof msg !== 'object') continue      // « null » est un JSON valide
    const isRequest = msg.id !== undefined && msg.id !== null

    if (msg.method === 'initialize') {
      send({ jsonrpc: '2.0', id: msg.id, result: {
        protocolVersion: msg.params?.protocolVersion ?? '2025-06-18',
        capabilities: { tools: {} },
        serverInfo: { name: 'exemple', version: '1.0.0' } } })
    } else if (msg.method === 'tools/list' && isRequest) {
      send({ jsonrpc: '2.0', id: msg.id, result: {
        tools: TOOLS.map(({ name, description, inputSchema }) => ({ name, description, inputSchema })) } })
    } else if (msg.method === 'tools/call' && isRequest) {
      const tool = TOOLS.find((t) => t.name === msg.params?.name)
      if (!tool) return send({ jsonrpc: '2.0', id: msg.id,
        error: { code: -32602, message: 'Outil inconnu' } })
      try {
        send({ jsonrpc: '2.0', id: msg.id,
          result: { content: [{ type: 'text', text: tool.run(msg.params.arguments ?? {}) }] } })
      } catch (e) {                                     // erreur d'EXÉCUTION : dans le résultat
        send({ jsonrpc: '2.0', id: msg.id,
          result: { content: [{ type: 'text', text: 'Erreur : ' + e.message }], isError: true } })
      }
    } else if (isRequest) {
      send({ jsonrpc: '2.0', id: msg.id, error: { code: -32601, message: 'Méthode inconnue' } })
    }
    // sans id : c'est une notification → on ne répond RIEN
  }
})
log('prêt')

{
  "mcpServers": {
    "paypedia": {
      "command": "node",
      "args": ["/path/to/paypedia/mcp/dist/paypedia-mcp.mjs"],
      "env": { "PAYPEDIA_ROOT": "/path/to/paypedia" }
    }
  }
}