mistral-mcp

Servidor MCP que expone las capacidades de Mistral AI a cualquier cliente MCP - Claude Code, Cursor, Zed, Windsurf, Claude Desktop.

Versión francesa: README.fr.md

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

Por qué

Mistral cuenta con modelos potentes para francés, código, OCR, moderación, audio y flujos de trabajo tipo agente, pero la mayoría de los IDE compatibles con MCP utilizan Anthropic u OpenAI por defecto. mistral-mcp proporciona a esas capacidades de Mistral una superficie MCP limpia para que puedas dirigir la subtarea correcta al modelo adecuado sin tener que reconstruir tu bucle de agente.

El objetivo de este repositorio no es ser "otro envoltorio ligero más". Aspira a ser un servidor MCP robusto y mantenible con esquemas explícitos, resultados predecibles, flexibilidad de transporte y una buena cobertura de pruebas.

Related MCP server: MCP Server TypeScript

Superficie actual (v0.4.0)

Herramientas (22)

Generación principal:

• mistral_chat

• mistral_chat_stream

• mistral_embed

• mistral_tool_call

• codestral_fim

Visión y audio:

• mistral_vision

• mistral_ocr

• voxtral_transcribe

• voxtral_speak

Agentes y clasificadores:

• mistral_agent

• mistral_moderate

• mistral_classify

Archivos y procesamiento por lotes:

• files_upload

• files_list

• files_get

• files_delete

• files_signed_url

• batch_create

• batch_list

• batch_get

• batch_cancel

Utilidad nativa de MCP:

• mcp_sample - delega la generación al modelo cliente mediante muestreo MCP

Recursos (2)

• mistral://models - alias aceptados y catálogo de modelos en vivo

• mistral://voices - catálogo de voces en vivo para Voxtral TTS

Prompts (6)

Prompts seleccionados en francés:

• french_invoice_reminder

• french_meeting_minutes

• french_email_reply

• french_commit_message

• french_legal_summary

Prompt seleccionado en inglés:

• codestral_review

Los argumentos de enumeración de los prompts están envueltos con completable(), por lo que los clientes MCP pueden solicitar la finalización de argumentos de prompt mediante completion/complete.

Aspectos destacados

• API McpServer de alto nivel con inputSchema, outputSchema y anotaciones en cada herramienta

• Soporte de transporte dual: stdio por defecto, HTTP transmitible para despliegues remotos

• Resultados estructurados en todas partes: structuredContent más alternativa de texto

• Soporte de muestreo MCP a través de mcp_sample

• Soporte de finalización de prompts para argumentos de tipo enumeración

• Recursos y prompts registrados junto con las herramientas, no añadidos posteriormente

• Reintento/retroceso y tiempo de espera de solicitud en el cliente del SDK de Mistral

Transporte

Stdio

Modo predeterminado. Es lo que utilizan Claude Code y la mayoría de los clientes MCP locales.

node dist/index.js

HTTP transmitible

Habilitar con --http o MCP_TRANSPORT=http.

MCP_TRANSPORT=http node dist/index.js

Variables de entorno relevantes:

• MCP_HTTP_HOST - predeterminado 127.0.0.1

• MCP_HTTP_PORT - predeterminado 3333

• MCP_HTTP_PATH - predeterminado /mcp

• MCP_HTTP_TOKEN - token de portador opcional

• MCP_HTTP_ALLOWED_ORIGINS - lista de permitidos opcional separada por comas

• MCP_HTTP_STATELESS=1 - modo de sesión sin estado

/healthz es intencionalmente público y no toca el servidor MCP.

Instalación

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

Establece tu clave de API:

export MISTRAL_API_KEY=your_key_here

O utiliza .env en la raíz del repositorio. Nunca lo subas al control de versiones.

Uso en Claude Code

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

Ejemplo de prompt:

Usa mistral_ocr en este PDF, luego ejecuta french_meeting_minutes en el texto extraído.

Desarrollo

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

Estrategia de pruebas

El conjunto contiene actualmente 148 pruebas en 4 capas:

1. Pruebas unitarias para herramientas, recursos, prompts, transporte, audio, agentes, archivos, procesamiento por lotes y muestreo

2. Pruebas de contrato para metadatos de herramientas y garantías orientadas a MCP

3. Pruebas de API en vivo contra la API real de Mistral cuando se establece MISTRAL_API_KEY

4. Pruebas de extremo a extremo de Stdio contra el servidor compilado

Sin MISTRAL_API_KEY, el valor predeterminado local es 139 aprobadas más 9 pruebas en vivo/stdio bloqueadas.

Diseño del proyecto

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

Estado

v0.4.0 — publicado. Consulta CHANGELOG.md para ver la diferencia completa respecto a v0.3.0:

• ayudantes compartidos, catálogos de modelos + voces en vivo, pruebas de contrato

• visión + OCR

• transcripción de audio + voz

• agentes + moderación + clasificación

• APIs de archivos + procesamiento por lotes

• transporte HTTP transmitible + muestreo MCP

• 5 prompts seleccionados en francés + 1 prompt en inglés + finalización de argumentos de prompt

Ejemplos

Los scripts ejecutables se encuentran en examples/. Consulta examples/README.md.

Licencia

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