MCP (Model Context Protocol): полный обзор — как подключить ИИ к данным компании

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { z } from 'zod';

// остатки живут в вашей системе; здесь — маленькая таблица для примера
const stock: Record<string, number> = { 'A-100': 8, 'B-200': 0 };

const server = new McpServer({ name: 'shop', version: '1.0.0' });

// инструмент: ассистент может его вызвать, а схема проверяет аргументы
server.registerTool(
  'get_stock',
  {
    title: 'Остаток по артикулу',
    description: 'Сколько единиц товара на складе',
    inputSchema: { sku: z.string().describe('Артикул товара, например A-100') },
    annotations: { readOnlyHint: true },
  },
  async ({ sku }) => {
    const qty = stock[sku];
    const text = qty === undefined ? `Нет товара ${sku}` : `${sku}: ${qty} шт.`;
    return { content: [{ type: 'text', text }] };
  },
);

await server.connect(new StdioServerTransport());

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

const server = new McpServer({ name: 'docs', version: '1.0.0' });

// ресурс: документ, который ассистент может прочитать, но не может изменить
server.registerResource(
  'delivery-terms',
  'docs://delivery-terms',
  { title: 'Условия доставки', mimeType: 'text/markdown' },
  async (uri) => ({
    contents: [{ uri: uri.href, text: '# Доставка\nКурьер: 1–2 дня. Самовывоз: в тот же день.' }],
  }),
);

await server.connect(new StdioServerTransport());

{
  "mcpServers": {
    "shop": {
      "command": "node",
      "args": ["/srv/mcp/shop.js"],
      "env": { "SHOP_API_KEY": "ключ-только-на-чтение" }
    }
  }
}