Swih/mistral-mcp

Завершение кода в режиме fill-in-the-middle с помощью Codestral. Имея prompt (код перед курсором) и suffix (код после курсора), Codestral дописывает середину. Используйте для автодополнения в редакторе, агентов патчинга кода или структурированных рефакторингов, где границы целевого участка известны. Токены остановки по умолчанию: [] — пусть модель решает сама. При необходимости переопределите через stop.

Создает завершение чата с использованием модели Mistral. Когда использовать: - Черновики контента на французском (или любом европейском языке), где Mistral показывает лучшие результаты. - Codestral для генерации и ревью кода. - Ministral для дешевой классификации с низкой задержкой. Возвращает структурированный контент с текстом ассистента и использованием токенов. НЕ поддерживает потоковую передачу - используйте mistral_chat_stream для длинных выходных данных с обновлениями прогресса.

Запускает Mistral OCR на PDF или изображении и возвращает структурированный Markdown для каждой страницы. Входной document - одно из значений: - { type: "document_url", documentUrl: "https://...pdf" } - { type: "image_url", imageUrl: "https://..." | "data:image/..." } - { type: "file", fileId: "<id-from-files-api>" } Параметры: - pages: массив номеров страниц с отсчётом от 0 или строка вида "0-5,7". - tableFormat: 'markdown' (по умолчанию) или 'html'. - extractHeader / extractFooter: включает верхний и нижний колонтитулы страницы, если они есть. - includeImageBase64: встраивает извлечённые байты изображений в формате base64 в ответ. - document_annotation_format: JSON-схема для структурированного извлечения данных из всего документа. - bbox_annotation_format: JSON-схема для извлечённых изображений и аннотаций с координатами ограничивающих рамок. - confidence_scores_granularity: 'page', 'word' или 'block'. Значение 'block' добавляет для каждого блока уверенность по содержимому и типу в pages[].blocks[].confidence_scores и требует OCR 4.1 или новее. - includeBlocks: возвращает блоки уровня абзаца (ограничивающая рамка + тип) в порядке чтения: заголовки, списки, таблицы, изображения, формулы, подписи, код, ссылки, выноски, верхний и нижний колонтитулы, подпись. Требует OCR 4 (mistral-ocr-4-0) или новее; старые модели принимают флаг, но возвращают пустой массив blocks. Возвращает pages[].markdown, а также опционально pages[].hyperlinks, header, footer, ограничивающие рамки images, blocks, аннотации, оценки уверенности и dimensions.

Завершение чата с мультимодальным вводом: текст + части image_url. Требуется модель, способная обрабатывать изображения. Принимаются: - pixtral-large-latest - pixtral-12b-latest - mistral-large-latest - mistral-medium-latest - mistral-small-latest Поле content каждого сообщения — это либо обычная строка (простой текст), либо массив частей { type: 'text', text } / { type: 'image_url', imageUrl }. URL изображения может быть HTTPS-ссылкой или data: URI в формате base64. Возвращает текст ассистента + использованные токены. Для запросов без изображений предпочтительнее использовать mistral_chat.

Конвейер из одного вызова: предоставленный текст/Markdown или Mistral OCR → классификация (если kind=auto) → типизированное извлечение → валидация. source.type=text пропускает OCR и загрузку файлов. Текст с kind=generic не выполняет API-вызовов; классификация и типизированное извлечение используют Mistral chat. Результаты предоставляют extraction_source. У предоставленного текста ocr_confidence и page_count равны null; ocr_text содержит переданный текст без изменений. Заменяет ручную цепочку mistral_ocr + mistral_chat + разбора JSON. Виды: contract | invoice | id_document | generic. Используйте kind=auto, чтобы сервер классифицировал сам. Возвращает размеченное объединение. Переключайтесь по kind, чтобы получить доступ к типизированным полям. Валидация проверяет схему и, для OCR-источников, уверенность OCR; не фактическую или бухгалтерскую точность. Типизированное извлечение отклоняет текст длиннее 60000 символов, а не обрезает его. Ключи кэша включают источник, kind, лимит страниц, endpoint, модели и версию конвейера. Переопределите расположение с помощью MISTRAL_MCP_CACHE_DIR. Переопределите режим с помощью options.cache. Режим кэша по умолчанию - 'read_write', КРОМЕ kind=id_document (автообход, чтобы не сохранять PII). Явно укажите options.cache='read_write', чтобы включить кэширование для id-документов. options.maxPages и options.minOcrConfidence применяются только к OCR-источникам. Нижний порог уверенности по умолчанию - 0.3. Ниже порога инструмент возвращает isError. Отсутствующие или частичные оценки уверенности также возвращают isError; используйте mistral_ocr напрямую, если нужен сырой OCR без гарантии уверенности. 0.3 - консервативная отправная точка, а не измеренная: откалибруйте порог под свой корпус с помощью npm run eval:docs.

Транскрибирует аудиофайл в текст с помощью Mistral Voxtral. Принятые модели: - voxtral-mini-latest - voxtral-small-latest Источник аудио — одно из: - { type: "file_url", fileUrl: "https://..." } (публичный URL) - { type: "file", fileId: "<id-from-files-api>" } Опции: - language: подсказка по ISO-639-1 (например 'fr', 'en'). Повышает точность, если язык известен. - temperature: температура сэмплирования. - diarize: возвращать разбивку по говорящим (по умолчанию false). - timestampGranularities: ['segment'] — возвращать временные метки для каждого сегмента. - contextBias: список фраз и терминов, которые должны влиять на декодер. Возвращает обычный text, определённый language, опциональные segments[] и информацию о расходе токенов.