VOOZH about

URL: https://glama.ai/mcp/servers/Swih/mistral-mcp?locale=zh-CN

⇱ mistral-mcp by Swih | Glama

mistral-mcp

将 Mistral AI 功能公开给任何 MCP 客户端的 MCP 服务器 - Claude Code、Cursor、Zed、Windsurf、Claude Desktop。

法语版本：README.fr.md

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

为什么选择它

Mistral 在法语、代码、OCR、审核、音频和智能体风格的工作流方面拥有强大的模型，但大多数支持 MCP 的 IDE 默认使用 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

提示词枚举参数使用 completable() 进行包装，因此 MCP 客户端可以通过 completion/complete 调用提示词参数补全。

亮点

  • 高级 McpServer API，每个工具都有 inputSchema、outputSchema 和注释

  • 双重传输支持：默认 stdio，支持远程部署的流式 HTTP

  • 到处都是结构化输出：structuredContent 加上文本回退

  • 通过 mcp_sample 支持 MCP 采样

  • 支持类枚举提示词参数的提示词补全

  • 资源和提示词与工具一起注册，而不是后期添加

  • Mistral SDK 客户端上的重试/退避和请求超时机制

传输

Stdio

默认模式。这是 Claude Code 和大多数本地 MCP 客户端使用的模式。

node dist/index.js

流式 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

示例提示词：

对此 PDF 使用 mistral_ocr，然后对提取的文本运行 french_meeting_minutes。

开发

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

测试策略

测试套件目前包含 148 个测试，分为 4 层：

  1. 工具、资源、提示词、传输、音频、智能体、文件、批处理和采样的单元测试

  2. 工具元数据和 MCP 保证的契约测试

  3. 设置 MISTRAL_API_KEY 时针对真实 Mistral API 的实时 API 测试

  4. 针对已构建服务器的 Stdio 端到端测试

如果没有 MISTRAL_API_KEY，本地默认运行 139 个通过测试，外加 9 个受限的实时/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

  • 流式 HTTP 传输 + MCP 采样

  • 5 个法语精选提示词 + 1 个英语提示词 + 提示词参数补全

示例

可运行脚本位于 examples/ 中。请参阅 examples/README.md。

许可证

MIT Copyright Dayan Decamp

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Swih/mistral-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server