Swih/mistral-mcp

Second major release. Adds Mistral function calling, Codestral FIM, the Resources and Prompts MCP primitives, doubles the test coverage, and ships the package on npm.

Install

npx -y mistral-mcp

Package: https://www.npmjs.com/package/mistral-mcp

New tools

• mistral_tool_call — OpenAI-style function calling with tool_choice (none / auto / any / required / specific function) and parallel_tool_calls. Returns parsed tool_calls in structuredContent. Does not execute the tools — hands the model's decision back to the caller. Source: docs.mistral.ai/capabilities/function_calling.
• codestral_fim — Fill-in-the-middle completion via mistral.fim.complete. Accepts prompt + suffix + optional stop tokens. Model allow-list enforces codestral-latest.

New primitives

• Resource mistral://models — JSON catalog of supported model aliases grouped by capability (chat / embed / fim / tool_capable). Sources cited inline.
• Prompt french_invoice_reminder(debtor_name, amount_eur, days_overdue, tone) — polite / firm / final tones, 120-word cap.
• Prompt codestral_review(diff, focus) — senior-review lens: correctness / performance / security / api_design.

Fixed

• Streaming handler now uses the proper CompletionEvent type imported from @mistralai/mistralai/models/components/completionevent.js — no more as { data?: unknown } cast.
• Streaming output captures finish_reason from the last choice and exposes it in structuredContent.
• bin / main paths stripped of leading ./ so npx mistral-mcp resolves correctly after publish.

Tests — 32 passing

• test/tools.unit.test.ts (11) — v0.2 tools
• test/fn.unit.test.ts (8) — function calling + FIM
• test/resources-prompts.unit.test.ts (7) — Resources + Prompts
• test/mistral.live.test.ts (4) — real Mistral API: chat, embeddings, function calling, FIM
• test/mcp.stdio.test.ts (2) — spawns dist/index.js, full MCP handshake over stdio

Examples

Two runnable scripts under examples/:

• try-it.mjs — smoke test over the npm-published package
• rate-it.mjs — feeds the README to Mistral Large through the MCP for a critical self-review

Spec compliance

MCP 2025-11-25. Full CHANGELOG: CHANGELOG.md.