@operstack/mcp 0.1.0 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operstack/mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server that lets Claude, Cursor and any MCP client measure a site the way a search engine and an AI read it: AI visibility score, llms.txt health, the sixteen content gates, and a full public-signal audit. Free data only, no account, nothing stored.",
   "type": "module",
   "license": "MIT",
@@ -40,7 +40,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@operstack/audit": "^0.13.1",
+    "@operstack/audit": "^0.23.0",
     "zod": "^4.6.2"
   }
 }

package/src/server.mjs

@@ -22,7 +22,7 @@ import { existsSync } from 'node:fs';
 import { collect, localiseChecks, AREAS_RU } from '@operstack/audit';
 import { checkLlms, normaliseSite } from './llms.mjs';
 
-export const VERSION = '0.1.0';
+export const VERSION = '0.2.0';
 
 const text = (value) => ({ content: [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }] });
 const fail = (message) => ({ content: [{ type: 'text', text: message }], isError: true });
@@ -33,10 +33,23 @@ function summarise(audit, lang) {
   const checks = ru ? localiseChecks(audit.checks || [], 'ru') : (audit.checks || []);
   const areaName = (k) => (ru ? (AREAS_RU[k] || k) : k);
   const open = checks.filter((c) => c.status === 'bad' || c.status === 'warn');
+  /*
+   * Главный балл в ответе обязателен.
+   *
+   * До 16.09.2026 здесь были только шесть областей из десяти, а число 0-100 отсутствовало. Это
+   * то самое число, которое человек видит на нашей странице и в удалённом MCP, и без него он не
+   * мог сопоставить ответ инструмента с тем, что показывает сайт. Число то же самое: аудит берёт
+   * его из той же проверки, проверено на шести живых сайтах, расхождений ноль.
+   */
+  const overall = typeof audit.overall === 'object' ? audit.overall?.score : audit.overall;
   return {
     site: audit.meta?.site,
     reachable: audit.meta?.reachable !== false,
     collectedAt: audit.meta?.collectedAt,
+    score: overall ?? (ru ? 'не измерялось' : 'not measured'),
+    scoreMeans: ru
+      ? 'Это тот же балл от 0 до 100, что показывает бесплатная проверка на oper-stack.ru. Шесть областей ниже это разбор того же сайта по другим вопросам, каждая из десяти.'
+      : 'This is the same 0 to 100 score the free check on oper-stack.com shows. The six areas below look at the same site from other angles, each out of ten.',
     pagesSampled: (audit.sample || []).filter((p) => p.title !== undefined).length,
     scores: Object.fromEntries(Object.entries(audit.scores || {}).map(([k, v]) => [areaName(k), v ?? (ru ? 'не измерялось' : 'not measured')])),
     failing: checks.filter((c) => c.status === 'bad').map((c) => ({ check: c.label, found: c.value })),
@@ -89,7 +102,12 @@ export function buildServer() {
       },
     },
     async ({ url, maxLinks = 20 }) => {
-      try { return text(await checkLlms(url, { maxLinks })); }
+      // Адрес приводим к корню, как и в остальных инструментах. Без этого «oper-stack.com»,
+      // адрес с путём и даже прямая ссылка на сам файл давали «llms.txt не найден» на сайте,
+      // где файл есть. Человек пишет адрес как придётся, и это наша работа, а не его.
+      let root;
+      try { root = normaliseSite(url); } catch (e) { return fail(e.message); }
+      try { return text(await checkLlms(root, { maxLinks })); }
       catch (e) { return fail(e.message); }
     },
   );

package/src/test-tools.mjs

@@ -7,8 +7,10 @@
  *   npm test
  *   npm test -- --live     ещё и сходить на живой сайт (медленнее, нужна сеть)
  */
+import { normaliseSite } from './llms.mjs';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { readFileSync } from 'node:fs';
 import { resolve, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -67,6 +69,26 @@ async function main() {
   }
 
   await client.close();
+  // ---- главный балл в ответе
+  // До 16.09.2026 устанавливаемый пакет отдавал шесть областей из десяти и ни разу не называл
+  // число 0-100, то самое, что человек видит на нашей странице. Сопоставить одно с другим было
+  // нельзя. Число берётся из той же проверки, расхождений нет: сверено на шести живых сайтах.
+  const serverSrc = readFileSync(resolve(ROOT, 'src/server.mjs'), 'utf8');
+  ok('ответ audit_site называет главный балл', /score: overall \?\?/.test(serverSrc));
+  ok('и объясняет, что это тот же балл, что на сайте', /scoreMeans:/.test(serverSrc)
+    && /бесплатная проверка на oper-stack\.ru/.test(serverSrc)
+    && /free check on oper-stack\.com/.test(serverSrc));
+
+  // ---- адрес, написанный по-человечески
+  // 16.09.2026 живой пользователь сообщил, что check_llms_txt отвечает «файла нет» на сайте, где
+  // файл есть: для этого инструмента адрес не приводился к корню, хотя для остальных приводился.
+  // Люди пишут адрес как придётся, и разобрать написание это наша работа, а не их.
+  for (const raw of ['oper-stack.com', 'www.oper-stack.com', 'https://oper-stack.com/products/gates/',
+                     'https://oper-stack.com/llms.txt', 'HTTPS://Oper-Stack.com']) {
+    const root = normaliseSite(raw);
+    ok(`адрес приводится к корню: ${raw}`, root === 'https://oper-stack.com' || root === 'https://www.oper-stack.com', root);
+  }
+
   if (failed) { console.error(`\n${failed} проверок упало`); process.exit(1); }
   console.log('\nсервер отвечает как положено');
 }