mistral-mcp

MCP-сервер, предоставляющий возможности Mistral AI для любого MCP-клиента — Claude Code, Cursor, Zed, Windsurf, Claude Desktop.

Version française : README.fr.md

👁 version
👁 license
👁 node
👁 typescript
👁 mcp-spec
👁 tools
👁 resources
👁 prompts
👁 tests

Зачем это нужно

Mistral обладает мощными моделями для французского языка, кода, OCR, модерации, аудио и агентских рабочих процессов, но большинство IDE с поддержкой MCP по умолчанию используют Anthropic или OpenAI. mistral-mcp предоставляет этим возможностям Mistral чистый интерфейс MCP, чтобы вы могли направлять нужную подзадачу нужной модели, не перестраивая свой агентский цикл.

Цель этого репозитория — не «очередная тонкая обертка». Он стремится быть надежным, поддерживаемым MCP-сервером с явными схемами, предсказуемыми результатами, гибкостью транспорта и хорошим покрытием тестами.

Related MCP server: MCP Server TypeScript

Текущий функционал (v0.4.0)

Инструменты (22)

Базовая генерация:

• mistral_chat

• mistral_chat_stream

• mistral_embed

• mistral_tool_call

• codestral_fim

Зрение и аудио:

• mistral_vision

• mistral_ocr

• voxtral_transcribe

• voxtral_speak

Агенты и классификаторы:

• mistral_agent

• mistral_moderate

• mistral_classify

Файлы и пакетная обработка:

• files_upload

• files_list

• files_get

• files_delete

• files_signed_url

• batch_create

• batch_list

• batch_get

• batch_cancel

Утилиты MCP:

• mcp_sample — делегирует генерацию клиентской модели через сэмплирование MCP

Ресурсы (2)

• mistral://models — принятые псевдонимы и актуальный каталог моделей

• mistral://voices — актуальный каталог голосов для Voxtral TTS

Промпты (6)

Французские промпты:

• french_invoice_reminder

• french_meeting_minutes

• french_email_reply

• french_commit_message

• french_legal_summary

Английский промпт:

• codestral_review

Аргументы перечислений (enum) в промптах обернуты в completable(), поэтому MCP-клиенты могут вызывать автодополнение аргументов промпта через completion/complete.

Основные особенности

• Высокоуровневый API McpServer с inputSchema, outputSchema и аннотациями для каждого инструмента

• Поддержка двойного транспорта: stdio по умолчанию, Streamable HTTP для удаленных развертываний

• Структурированные выводы везде: structuredContent плюс текстовый резервный вариант

• Поддержка сэмплирования MCP через mcp_sample

• Поддержка автодополнения для аргументов промптов типа enum

• Ресурсы и промпты регистрируются вместе с инструментами, а не добавляются позже

• Повторные попытки/экспоненциальная задержка и тайм-аут запросов в клиенте Mistral SDK

Транспорт

Stdio

Режим по умолчанию. Это то, что используют Claude Code и большинство локальных MCP-клиентов.

node dist/index.js

Streamable HTTP

Включите с помощью --http или MCP_TRANSPORT=http.

MCP_TRANSPORT=http node dist/index.js

Соответствующие переменные окружения:

• MCP_HTTP_HOST — по умолчанию 127.0.0.1

• MCP_HTTP_PORT — по умолчанию 3333

• MCP_HTTP_PATH — по умолчанию /mcp

• MCP_HTTP_TOKEN — опциональный токен bearer

• MCP_HTTP_ALLOWED_ORIGINS — опциональный список разрешенных источников через запятую

• MCP_HTTP_STATELESS=1 — режим сессии без сохранения состояния

/healthz намеренно является публичным и не затрагивает MCP-сервер.

Установка

git clone https://github.com/Swih/mistral-mcp.git
cd mistral-mcp
npm install
npm run build

Установите свой API-ключ:

export MISTRAL_API_KEY=your_key_here

Или используйте .env в корне репозитория. Никогда не добавляйте его в коммиты.

Использование в Claude Code

claude mcp add mistral -- node /absolute/path/to/mistral-mcp/dist/index.js

Пример промпта:

Use mistral_ocr on this PDF, then run french_meeting_minutes on the extracted text.

Разработка

npm run dev
npm run build
npm run lint
npm test
npm run inspector

Стратегия тестирования

Набор тестов в настоящее время содержит 148 тестов на 4 уровнях:

1. Модульные тесты для инструментов, ресурсов, промптов, транспорта, аудио, агентов, файлов, пакетной обработки и сэмплирования

2. Контрактные тесты для метаданных инструментов и гарантий MCP

3. Тесты API в реальном времени при установленном MISTRAL_API_KEY

4. Сквозные тесты Stdio для собранного сервера

Без MISTRAL_API_KEY локально выполняется 139 тестов плюс 9 тестов с ограничением (live/stdio).

Структура проекта

mistral-mcp/
|-- src/
| |-- index.ts
| |-- transport.ts
| |-- tools.ts
| |-- tools-fn.ts
| |-- tools-vision.ts
| |-- tools-audio.ts
| |-- tools-agents.ts
| |-- tools-files.ts
| |-- tools-batch.ts
| |-- tools-sampling.ts
| |-- resources.ts
| `-- prompts.ts
|-- test/
|-- examples/
|-- .github/workflows/ci.yml
|-- package.json
`-- tsconfig.test.json

Статус

v0.4.0 — выпущено. См. CHANGELOG.md для полного списка изменений по сравнению с v0.3.0:

• общие вспомогательные функции, каталоги моделей и голосов, контрактные тесты

• зрение + OCR

• транскрипция аудио + речь

• агенты + модерация + классификация

• API файлов + пакетной обработки

• транспорт Streamable HTTP + сэмплирование MCP

• 5 французских промптов + 1 английский промпт + автодополнение аргументов промптов

Примеры

Запускаемые скрипты находятся в examples/. См. examples/README.md.

Лицензия

MIT Copyright Dayan Decamp

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• codestral_fimA
• mistral_chatA
• mistral_ocrA
• mistral_visionA
• voxtral_transcribeA
• workflow_executeA
• workflow_interactA
• workflow_statusA