@sbissoli/mcp-surface 0.1.1 → 0.2.1

package/CHANGELOG.md

@@ -8,6 +8,43 @@ seguinte — cada servidor faz bump explícito).
 e, pela regra da trava, obrigaria cada servidor a subir de versão sem ter mudado nada.
 Mudança de normalização é major (ou minor em 0.x), com nota de migração.
 
+## [0.2.1] — 2026-10-04
+
+A normalização NÃO muda. Patch: a API de `/cliente` é a mesma; os controles negativos
+ficam mais fortes, e os servidores herdam isso pelo caret `^0.2.0`.
+
+### Corrigido
+
+- **A troca de tipo cobria UM campo só.** `quebrasDoSchema` trocava o tipo do primeiro
+  obrigatório tipado. No ilo-mcp-server esse campo era um objeto (`dataflow`), e os
+  escalares ficavam sem prova, o que obrigou a escrever `rows_count` como quebra extra à
+  mão. Agora a troca vale para CADA obrigatório com `type` declarado.
+- **O campo anulável não era trocado.** `type: ["string", "null"]` (lista) não gerava
+  quebra, e é justamente a classe do defeito que o circuito existe para pegar. O valor
+  errado agora é o primeiro de texto, número, booleano, lista e objeto que nenhum dos tipos
+  declarados aceita.
+- **As quebras rodam em paralelo.** Com uma troca por obrigatório, em série,
+  `loinc_details` do medical-terminologies-mcp passava dos 5 s do vitest sob a carga da
+  suíte. Cada quebra já tinha servidor e conexão próprios. A ordem dos vereditos não muda,
+  e a armadilha continua sendo o último.
+
+Conferido contra os sete servidores com o build local antes de publicar: todos verdes.
+
+## [0.2.0] — 2026-10-04
+
+A normalização NÃO muda: todo `surface.lock.json` continua conferindo. Minor porque a
+superfície publicada do pacote cresce (subpath novo).
+
+### Adicionado
+
+- **`@sbissoli/mcp-surface/cliente`**: o teste com forma de cliente, que nasceu no
+  ilo-mcp-server 1.3.0 (ideia de leitor, https://dev.to/arhancanli/comment/3g4i4).
+  `conectarComoCliente` (transporte em memória com JSON no fio), `chamarComoCliente`
+  (`tools/list` antes do `tools/call`, lança se o `Client` reprovar ou vier `isError`),
+  `controlesNegativos` (quebras derivadas do `outputSchema` listado, mais a armadilha do
+  `tools/list` ausente) e `quebrasDoSchema`. `@modelcontextprotocol/client` entra como peer
+  OPCIONAL; a raiz do pacote continua sem o `Client`, que o Worker não pode carregar.
+
 ## [0.1.1] — 2026-10-02
 
 Achados da adoção nos irmãos, no mesmo dia. A normalização NÃO muda: todo

package/README.md

@@ -70,6 +70,37 @@ travar superfície nova sob a versão antiga.
 Fluxo de quem muda a superfície: `npm version <nível> --no-git-tag-version` →
 `npm run surface:lock` → commitar o lock junto.
 
+## Teste com forma de cliente (`@sbissoli/mcp-surface/cliente`)
+
+O servidor interrogado pelo `Client` do SDK, que reprova o resultado de `tools/call`
+contra o `outputSchema` **listado**. Assim o teste falha como a sessão do usuário falharia,
+sem um validador escolhido por nós. É subpath à parte porque o `Client` compila schemas
+com Ajv (`new Function`), que o Worker proíbe: só se importa em teste Node, e o
+`@modelcontextprotocol/client` é peer opcional.
+
+```ts
+import { chamarComoCliente, conectarComoCliente, controlesNegativos } from "@sbissoli/mcp-surface/cliente";
+
+const client = await conectarComoCliente(buildServer(env));
+const r = await chamarComoCliente(client, "minha_tool", { x: 1 }); // lança se o Client reprovar ou se vier isError
+
+const vs = await controlesNegativos(() => buildServer(env), "minha_tool", { x: 1 });
+for (const v of vs) expect(v.obtido, `${v.descricao}: ${v.mensagem ?? ""}`).toBe(v.esperado);
+```
+
+- `conectarComoCliente` passa toda mensagem do servidor por JSON antes de entregá-la: o
+  transporte em memória não serializa, e chave `undefined` só some no fio.
+- `chamarComoCliente` faz `tools/list` antes do primeiro `tools/call` da conexão. Sem
+  isso, o `Client` (2.0 a 2.2) devolve o resultado sem validar.
+- `controlesNegativos` adultera o resultado entre servidor e cliente, com quebras
+  **derivadas do schema listado**: `structuredContent` ausente, cada obrigatório ausente e
+  cada obrigatório com `type` declarado recebendo um valor que nenhum tipo dele aceita (o
+  anulável `["string", "null"]` recebe `0`). As quebras rodam em paralelo, cada uma com
+  servidor próprio. Cada quebra tem de fazer a chamada falhar. O
+  último veredito é a armadilha (sem `tools/list`, a quebra passa calada); se o SDK mudar,
+  ele acusa. Quebras do próprio servidor, como campo a mais onde o schema fecha o objeto,
+  entram pelo 4º argumento.
+
 ## Observações
 
 - Uma atualização do SDK que mexa nas `capabilities` também acende a trava — de propósito:

package/dist/cliente.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Teste com forma de cliente: o servidor interrogado pelo `Client` do SDK, que
+ * reprova o resultado de `tools/call` contra o `outputSchema` LISTADO — o teste
+ * falha como a sessão do usuário falharia, sem validador escolhido por nós.
+ *
+ * Ideia de leitor (https://dev.to/arhancanli/comment/3g4i4); o circuito nasceu
+ * no ilo-mcp-server 1.3.0 e mora aqui para os sete servidores o usarem igual.
+ *
+ * Subpath próprio (`@sbissoli/mcp-surface/cliente`), fora da raiz do pacote: o
+ * `Client` compila os schemas com Ajv (`new Function`), que o runtime da
+ * Cloudflare proíbe. Importar daqui é coisa de teste em Node, nunca de Worker.
+ *
+ * Duas armadilhas que este módulo fecha, medidas no ilo:
+ * - o `Client` só valida contra o schema que tem em cache do `tools/list` —
+ *   sem `listTools` antes, `callTool` devolve o que recebeu sem validar;
+ * - o `InMemoryTransport` não serializa: chave `undefined` sobrevive em memória
+ *   e some no fio (`JSON.stringify`). Aqui toda mensagem do servidor passa por
+ *   JSON antes de chegar ao cliente, como passaria pela rede.
+ */
+import { Client } from "@modelcontextprotocol/client";
+import type { ServidorConectavel } from "./memoria.js";
+/** Resultado de `tools/call` como viaja no fio (o que uma quebra recebe). */
+export type ResultadoNoFio = {
+    content?: unknown;
+    structuredContent?: Record<string, unknown>;
+} & Record<string, unknown>;
+export interface OpcoesConexao {
+    /** Mexe no resultado de `tools/call` entre servidor e cliente (controle negativo). */
+    adulterar?: (r: ResultadoNoFio) => void;
+}
+export declare function conectarComoCliente(server: ServidorConectavel, opcoes?: OpcoesConexao): Promise<Client>;
+/**
+ * Chamada que TEM de dar certo, no percurso do cliente. Lança quando o `Client`
+ * reprova o resultado e também quando a tool responde `isError` — o servidor do
+ * SDK v2 valida a própria saída e, se ela não obedece, devolve o erro em
+ * `isError` ("Output validation error"), não em exceção. Para afirmar uma
+ * recusa de propósito (parâmetro inválido), use `client.callTool` direto.
+ */
+export declare function chamarComoCliente(client: Client, nome: string, args?: Record<string, unknown>): Promise<{
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+        "io.modelcontextprotocol/serverInfo"?: {
+            version: string;
+            websiteUrl?: string | undefined;
+            description?: string | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "dark" | "light" | undefined;
+            }[] | undefined;
+            name: string;
+            title?: string | undefined;
+        } | undefined;
+    } | undefined;
+    content: ({
+        type: "text";
+        text: string;
+        annotations?: {
+            audience?: ("assistant" | "user")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
+        annotations?: {
+            audience?: ("assistant" | "user")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        type: "audio";
+        data: string;
+        mimeType: string;
+        annotations?: {
+            audience?: ("assistant" | "user")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        uri: string;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+        size?: number | undefined;
+        annotations?: {
+            audience?: ("assistant" | "user")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+            theme?: "dark" | "light" | undefined;
+        }[] | undefined;
+        name: string;
+        title?: string | undefined;
+        type: "resource_link";
+    } | {
+        type: "resource";
+        resource: {
+            uri: string;
+            mimeType?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            text: string;
+        } | {
+            uri: string;
+            mimeType?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            blob: string;
+        };
+        annotations?: {
+            audience?: ("assistant" | "user")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    })[];
+    structuredContent?: unknown;
+    isError?: boolean | undefined;
+}>;
+export interface Quebra {
+    descricao: string;
+    adulterar: (r: ResultadoNoFio) => void;
+}
+/**
+ * As quebras genéricas, DERIVADAS do schema listado (não de nomes escritos à
+ * mão): `structuredContent` ausente, cada campo obrigatório ausente, e cada
+ * obrigatório com tipo declarado trocado de tipo. Cada um, não o primeiro: até a
+ * 0.2.0 só o primeiro tipado era trocado, e no ilo esse caía num objeto
+ * (`dataflow`) e deixava os escalares sem prova.
+ */
+export declare function quebrasDoSchema(outputSchema: Record<string, unknown>): Quebra[];
+export interface Veredito {
+    descricao: string;
+    /** O que o circuito exige: o cliente reprovar a quebra (ou, na armadilha, deixá-la passar). */
+    esperado: "reprova" | "passa";
+    /** `isError`: a chamada-base falhou como tool — o caso está mal montado. */
+    obtido: "reprova" | "passa" | "isError";
+    mensagem?: string;
+}
+/**
+ * Controle negativo pelo lado do resultado: o servidor responde certo, o que
+ * chega ao cliente está quebrado, e a chamada TEM de falhar. Um servidor novo
+ * por quebra (`fabrica`), porque cada conexão leva a sua adulteração.
+ *
+ * Inclui a armadilha como veredito esperado "passa": sem `tools/list` antes, a
+ * primeira quebra passa calada. Se um dia o SDK passar a validar sem a lista,
+ * esse veredito acusa — e a regra do `listTools` pode ser revista.
+ *
+ * O teste afirma `obtido === esperado` em cada veredito; a `descricao` diz qual.
+ */
+export declare function controlesNegativos(fabrica: () => ServidorConectavel | Promise<ServidorConectavel>, nome: string, args?: Record<string, unknown>, extras?: Quebra[]): Promise<Veredito[]>;
+//# sourceMappingURL=cliente.d.ts.map

package/dist/cliente.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliente.d.ts","sourceRoot":"","sources":["../src/cliente.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAGtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1H,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;CACzC;AAID,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAYjH;AAWD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAOvG;AAED,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;CACxC;AAsBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAqB/E;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,+FAA+F;IAC/F,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,4EAA4E;IAC5E,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,EAC/D,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,MAAM,GAAE,MAAM,EAAO,GACpB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAuCrB"}

package/dist/cliente.js

@@ -0,0 +1,164 @@
+/**
+ * Teste com forma de cliente: o servidor interrogado pelo `Client` do SDK, que
+ * reprova o resultado de `tools/call` contra o `outputSchema` LISTADO — o teste
+ * falha como a sessão do usuário falharia, sem validador escolhido por nós.
+ *
+ * Ideia de leitor (https://dev.to/arhancanli/comment/3g4i4); o circuito nasceu
+ * no ilo-mcp-server 1.3.0 e mora aqui para os sete servidores o usarem igual.
+ *
+ * Subpath próprio (`@sbissoli/mcp-surface/cliente`), fora da raiz do pacote: o
+ * `Client` compila os schemas com Ajv (`new Function`), que o runtime da
+ * Cloudflare proíbe. Importar daqui é coisa de teste em Node, nunca de Worker.
+ *
+ * Duas armadilhas que este módulo fecha, medidas no ilo:
+ * - o `Client` só valida contra o schema que tem em cache do `tools/list` —
+ *   sem `listTools` antes, `callTool` devolve o que recebeu sem validar;
+ * - o `InMemoryTransport` não serializa: chave `undefined` sobrevive em memória
+ *   e some no fio (`JSON.stringify`). Aqui toda mensagem do servidor passa por
+ *   JSON antes de chegar ao cliente, como passaria pela rede.
+ */
+import { Client } from "@modelcontextprotocol/client";
+import { InMemoryTransport } from "@modelcontextprotocol/server";
+const listados = new WeakSet();
+export async function conectarComoCliente(server, opcoes = {}) {
+    const [lado, ladoServidor] = InMemoryTransport.createLinkedPair();
+    const enviar = ladoServidor.send.bind(ladoServidor);
+    ladoServidor.send = async (mensagem, extra) => {
+        const noFio = JSON.parse(JSON.stringify(mensagem));
+        const r = noFio.result;
+        if (opcoes.adulterar && r && "content" in r)
+            opcoes.adulterar(r);
+        return enviar(noFio, extra);
+    };
+    const client = new Client({ name: "mcp-surface/cliente", version: "0.0.0" });
+    await Promise.all([server.connect(ladoServidor), client.connect(lado)]);
+    return client;
+}
+/** O percurso do cliente: `tools/list` (uma vez por conexão) → `tools/call`. */
+async function percorrer(client, nome, args) {
+    if (!listados.has(client)) {
+        await client.listTools();
+        listados.add(client);
+    }
+    return client.callTool({ name: nome, arguments: args });
+}
+/**
+ * Chamada que TEM de dar certo, no percurso do cliente. Lança quando o `Client`
+ * reprova o resultado e também quando a tool responde `isError` — o servidor do
+ * SDK v2 valida a própria saída e, se ela não obedece, devolve o erro em
+ * `isError` ("Output validation error"), não em exceção. Para afirmar uma
+ * recusa de propósito (parâmetro inválido), use `client.callTool` direto.
+ */
+export async function chamarComoCliente(client, nome, args = {}) {
+    const r = await percorrer(client, nome, args);
+    if (r.isError) {
+        const texto = Array.isArray(r.content) ? r.content.map(c => ("text" in c ? c.text : "")).join(" ") : "";
+        throw new Error(`${nome} respondeu isError: ${texto}`);
+    }
+    return r;
+}
+/** Candidatos a valor errado, com os tipos JSON Schema que cada um satisfaz. */
+const CANDIDATOS = [
+    ["valor-de-tipo-errado", ["string"]],
+    [0, ["number", "integer"]],
+    [true, ["boolean"]],
+    [[], ["array"]],
+    [{}, ["object"]],
+];
+/**
+ * Um valor que NENHUM dos tipos declarados aceita — `type` simples ou lista
+ * (`["string", "null"]`, o campo anulável, que é onde o defeito mora). Sem
+ * `type` declarado não há o que trocar: `undefined`.
+ */
+function tipoErrado(tipo) {
+    const tipos = typeof tipo === "string" ? [tipo] : Array.isArray(tipo) ? tipo : [];
+    if (tipos.length === 0)
+        return undefined;
+    return CANDIDATOS.find(([, aceitos]) => !aceitos.some(t => tipos.includes(t)))?.[0];
+}
+/**
+ * As quebras genéricas, DERIVADAS do schema listado (não de nomes escritos à
+ * mão): `structuredContent` ausente, cada campo obrigatório ausente, e cada
+ * obrigatório com tipo declarado trocado de tipo. Cada um, não o primeiro: até a
+ * 0.2.0 só o primeiro tipado era trocado, e no ilo esse caía num objeto
+ * (`dataflow`) e deixava os escalares sem prova.
+ */
+export function quebrasDoSchema(outputSchema) {
+    const obrigatorios = Array.isArray(outputSchema.required) ? outputSchema.required : [];
+    const props = (outputSchema.properties ?? {});
+    const quebras = [
+        { descricao: "structuredContent ausente", adulterar: r => void delete r.structuredContent },
+        ...obrigatorios.map(campo => ({
+            descricao: `campo obrigatório ausente (${campo})`,
+            adulterar: (r) => void delete r.structuredContent?.[campo],
+        })),
+    ];
+    for (const campo of obrigatorios) {
+        const errado = tipoErrado(props[campo]?.type);
+        if (errado === undefined)
+            continue;
+        quebras.push({
+            descricao: `campo de tipo errado (${campo})`,
+            adulterar: r => {
+                if (r.structuredContent)
+                    r.structuredContent[campo] = structuredClone(errado);
+            },
+        });
+    }
+    return quebras;
+}
+/**
+ * Controle negativo pelo lado do resultado: o servidor responde certo, o que
+ * chega ao cliente está quebrado, e a chamada TEM de falhar. Um servidor novo
+ * por quebra (`fabrica`), porque cada conexão leva a sua adulteração.
+ *
+ * Inclui a armadilha como veredito esperado "passa": sem `tools/list` antes, a
+ * primeira quebra passa calada. Se um dia o SDK passar a validar sem a lista,
+ * esse veredito acusa — e a regra do `listTools` pode ser revista.
+ *
+ * O teste afirma `obtido === esperado` em cada veredito; a `descricao` diz qual.
+ */
+export async function controlesNegativos(fabrica, nome, args = {}, extras = []) {
+    const sonda = await conectarComoCliente(await fabrica());
+    let schema;
+    try {
+        const { tools } = await sonda.listTools();
+        schema = tools.find(t => t.name === nome)?.outputSchema;
+    }
+    finally {
+        await sonda.close();
+    }
+    if (!schema)
+        throw new Error(`${nome}: sem outputSchema no tools/list — não há contrato a provar`);
+    const quebras = [...quebrasDoSchema(schema), ...extras];
+    const rodar = async (q, listar) => {
+        const client = await conectarComoCliente(await fabrica(), { adulterar: q.adulterar });
+        try {
+            const r = listar ? await percorrer(client, nome, args) : await client.callTool({ name: nome, arguments: args });
+            // Erro de tool NÃO é reprovação do validador: a chamada-base tem de dar
+            // certo, ou o controle não prova nada — veredito que nunca confere.
+            if (r.isError)
+                return { obtido: "isError", mensagem: JSON.stringify(r.content) };
+            return { obtido: "passa" };
+        }
+        catch (e) {
+            return { obtido: "reprova", mensagem: e instanceof Error ? e.message : String(e) };
+        }
+        finally {
+            await client.close();
+        }
+    };
+    // Em paralelo: cada quebra tem servidor e conexão próprios. Desde a 0.2.1 há
+    // uma troca de tipo por obrigatório, e em série o medical (`loinc_details`,
+    // muitos obrigatórios) passava dos 5 s do vitest sob a carga da suíte.
+    const armadilha = quebras[1] ?? quebras[0];
+    return Promise.all([
+        ...quebras.map(async (q) => ({ descricao: q.descricao, esperado: "reprova", ...(await rodar(q, true)) })),
+        rodar(armadilha, false).then(r => ({
+            descricao: `a armadilha: sem tools/list antes, "${armadilha.descricao}" passa calada`,
+            esperado: "passa",
+            ...r,
+        })),
+    ]);
+}
+//# sourceMappingURL=cliente.js.map

package/dist/cliente.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliente.js","sourceRoot":"","sources":["../src/cliente.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sbissoli/mcp-surface",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Impressão digital da superfície de um servidor MCP: initialize (instructions + capabilities) + tools/resources/prompts + quem responde sem token, travados ao lado da versão — mudou sem subir a versão = build vermelho e deploy recusado; mais a conferência do endpoint no ar e o replay das versões publicadas",
   "repository": {
     "type": "git",
@@ -17,6 +17,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./cliente": {
+      "types": "./dist/cliente.d.ts",
+      "default": "./dist/cliente.js"
     }
   },
   "bin": {
@@ -33,9 +37,16 @@
     "test": "vitest run"
   },
   "peerDependencies": {
+    "@modelcontextprotocol/client": "^2.0.0",
     "@modelcontextprotocol/server": "^2.0.0"
   },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/client": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@modelcontextprotocol/client": "^2.1.0",
     "@modelcontextprotocol/server": "^2.1.0"
   },
   "keywords": [