SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI智能体mistral-mcp

mistral-mcp

mistral-mcp 是一个基于 Mistral AI 的 MCP 服务器，主要用于文档信息提取。它可以将文本或 Markdown 格式的发票、合同、身份证明文件转换成结构化的 JSON 数据，并通过 Mistral 聊天模型验证响应模式，可选 Mistral OCR 处理 PDF 和图像。核心提供六个工具，支持聊天、视觉、音频、代码补全等功能，以及 stdio 和 Streamable HTTP 传输方式。

访问官网

工具介绍

用途

mistral-mcp 是一个 MCP（Model Context Protocol）服务器，核心用途是将发票、合同、身份证明文件等文档转换为类型化 JSON。它通过 Mistral 聊天模型提取供应商、总额、行项目、到期日期等字段，并对响应模式进行验证。对于 PDF 和图像输入，可选使用 Mistral OCR。

主要能力

  • 六工具核心：默认提供六个工具，包括聊天、视觉、转录、代码补全等。
  • 文档提取：支持 process_document 工具，可从文本、Markdown、文档 URL、base64 图像或已上传文件 ID 中提取结构化数据。kind 参数支持 auto（默认）、invoice、contract、id_document、generic。
  • OCR 支持：可选 Mistral OCR 处理 PDF、PNG、JPEG、WebP 文件，单文件最大 20 MiB。
  • 配置档案：通过 MISTRAL_MCP_PROFILE 选择五种档案之一，默认 core 用于 Mistral Cloud；自定义 MISTRAL_BASE_URL 时推断为自托管，除非显式设置档案。
  • 缓存机制：缓存文件存储提取内容，MISTRAL_MCP_CACHE_DIR 设置位置，MISTRAL_MCP_CACHE_TTL_HOURS 默认 168 小时。身份证明文件默认绕过缓存。

使用方式

环境要求

需要 Node.js 20+、npm 以及具有相应模型访问权限和配额的 Mistral API 密钥。

安装到 MCP 客户端

对于使用 mcpServers JSON 的客户端，配置 stdio 服务器，运行 npx -y mistral-mcp@1.0.0。重启客户端并刷新工具目录。服务器读取客户端提供的环境变量，不会自动加载 .env 文件。

快速开始（文本或 Markdown 发票）

示例脚本和固定装置为源示例，不包含在 npm 包中。从仓库根目录检出发布标签并构建：

  1. 在环境或本地 .env 文件中设置密钥和聊天模型。
  2. 示例使用 dotenv 加载 .env。将密钥排除在版本控制之外。
  3. 选择账户中有配额的聊天模型；默认模型配额可能为零。

脚本在本地读取文本，并通过本地服务器的核心档案调用 process_document，参数为 source: { type: "text", text: "..." }、kind: "invoice" 和 options.cache: "bypass"。文本必须包含非空白内容，且不超过 60,000 个 UTF-16 代码单元。Markdown 和空白字符原样保留。

不使用 --output 时打印验证后的 JSON；使用时会写入新文件并打印路径。现有文件不会被覆盖。输出路径在 API 调用前预留，失败后可能保持为空。

OCR 路由

对于 PDF 或图像，使用 OCR 路由：上传文件，调用 process_document，并在 finally 块中尝试删除上传内容（包括提取失败后）。需要 Files、OCR 和聊天访问权限及配额。已知限制：测试账户的 HTTP 429 / 零 OCR 配额阻止了实时 OCR 验证。

适用场景

  • 从文本或 Markdown 发票中提取供应商、总额、行项目、到期日期等结构化数据。
  • 处理合同、身份证明文件的自动分类和类型化提取。
  • 需要聊天、视觉、音频转录、代码补全的 MCP 集成场景。

限制

  • 模式验证仅检查响应的结构和类型，不验证事实准确性、发票算术、税务处理或会计正确性。使用前需对照源文件审查提取字段。
  • 文本必须包含非空白内容且不超过 60,000 个 UTF-16 代码单元。
  • 类型化提取拒绝超过 60,000 个 UTF-16 代码单元的 OCR 文本；需拆分文档或使用 generic。
  • options.maxPages 和 options.minOcrConfidence 仅适用于 OCR 源。默认 0.3 未经测量；OCR 置信度不建立提取准确性。
  • 本地 MCP 托管仍将提取请求发送到 Mistral。默认请求发往 Mistral Cloud；本地托管不会使文档推断本地化。
  • 模型访问和免费配额取决于账户，调用前需检查限制。
  • 自定义 MISTRAL_BASE_URL 不包含 OCR 或 process_document。
  • 不提供集成 OAuth。
  • 2026-09-28 的文本测试和 CLI 示例使用 ministral-3b-latest 仅通过聊天成功，验证了一个合成发票，并非通用准确性或可靠性评分。

版本说明

版本 1.0.0 与 0.11.0 有破坏性变更：核心现暴露六个工具；现有编排客户端必须选择显式档案。文档结果需要 extraction_source，ocr_confidence / page_count 可能为 null。

其他信息

  • 许可证：MIT，版权 Dayan Decamp。
  • 提供 npx -y mistral-mcp@1.0.0 --doctor 报告本地档案和工具列表，不进行 API 调用。
  • mistral://capabilities 资源报告活动端点、工具族和省略工具的原因。

同类工具

查看分类