Mistral Ocr MCP 0f351ee4

MCP文档知识

提供方 filonenkoalex

文档知识 stdio · 本地进程 API Key 社区 / 第三方 Claude DesktopClaudeVS Code
查看接入方式

一个使用Mistral OCR API将PDF文档转换为Markdown格式的MCP服务器,支持本地文件和URL处理,并能提取和保存图片。

一句话选型结论

按资料字段整理

Mistral Ocr MCP 0f351ee4 属于文档知识类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude Desktop、Claude、VS Code,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 2 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量2暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

PDF处理Python本地部署文档转换OCR技术Markdown生成自动化工具

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
uvx --from . mistral-ocr-mcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 2 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 2 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、VS Code,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Mistral Ocr MCP 0f351ee4当前 2 stdio · 本地进程 本地部署 有 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方filonenkoalex上游标注的维护方 filonenkoalex
分类文档知识本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.4 KB
来自项目仓库与上游目录的原文,未做删改

Mistral OCR MCP Server

A Model Context Protocol (MCP) server that converts PDF documents to Markdown using Mistral's OCR API.

Features

  • Convert PDF files to Markdown format using Mistral OCR
  • Support for both local PDF files and URLs
  • Automatic file upload and processing for local PDFs
  • Configurable output directory via environment variables
  • Image extraction: Extract and save images from PDFs with automatic path correction
  • Multi-page document support with page markers
  • Preserves document structure, tables, and formatting

Prerequisites

  • Python 3.10 or higher
  • UV package manager
  • Mistral API key (Get one here)

Installation

1. Install UV (if not already installed)```bash

On macOS and Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

On Windows

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"


### 2. Clone and setup the project```bash
cd mistral-ocr-mcp

# Copy the example environment file
cp .env.example .env

# Edit .env and add your Mistral API key
# MISTRAL_API_KEY=your_api_key_here

3. Install dependencies with UV```bash

uv sync


## Configuration

Create a `.env` file in the project root with the following variables:```bash
# Required: Your Mistral API key
MISTRAL_API_KEY=your_api_key_here

# Optional: Output directory for converted files (defaults to ./output)
MISTRAL_OUTPUT_DIR=./output

Usage

Running with UV```bash

Run directly with uvx (no installation needed)

uvx --from . mistral-ocr-mcp

Or with uv run

uv run mistral-ocr-mcp


### Running in development mode```bash
uv run python -m mistral_ocr_mcp.server

MCP Client Configuration

To use this server with an MCP client (like Claude Desktop), add it to your MCP configuration:

For Claude Desktop

Add to your claude_desktop_config.json:```json
{
"mcpServers": {
"mistral-ocr": {
"command": "uvx",
"args": [
"--from",
"C:\Projects\GitHub\mistral-ocr-mcp",
"mistral-ocr-mcp"
],
"env": {
"MISTRAL_API_KEY": "your_api_key_here",
"MISTRAL_OUTPUT_DIR": "C:\path\to\output"
}
}
}
}


Or use the local path with `uv`:```json
{
  "mcpServers": {
    "mistral-ocr": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Projects\\GitHub\\mistral-ocr-mcp",
        "run",
        "mistral-ocr-mcp"
      ],
      "env": {
        "MISTRAL_API_KEY": "your_api_key_here",
        "MISTRAL_OUTPUT_DIR": "C:\\path\\to\\output"
      }
    }
  }
}

Available Tools

convert_pdf_to_markdown

Converts a PDF document to Markdown format.

Parameters:
- source (required): Path to local PDF file or URL to PDF document
- output_filename (optional): Custom output filename without extension
- include_images (optional): Whether to include base64-encoded images (default: false)

Example without images:```json
{
"source": "C:\documents\report.pdf",
"output_filename": "my_report",
"include_images": false
}


**Example with image extraction:**```json
{
  "source": "https://arxiv.org/pdf/2501.00663",
  "output_filename": "research_paper",
  "include_images": true
}

get_output_directory

Returns the current output directory path.

Features in Detail

Local PDF Processing

The server handles local PDFs by:
1. Uploading the file to Mistral's secure storage
2. Generating a signed URL
3. Processing the document with OCR
4. Saving the markdown output locally

URL-based Processing

PDFs accessible via URL are processed directly without upload:```json
{
"source": "https://arxiv.org/pdf/2501.00663"
}


### Multi-page Documents

Each page is processed and marked with a comment in the output:```markdown

[Content from page 1]

[Content from page 2]

Image Extraction

When include_images is set to true, the server will:

  1. Create a document folder with the PDF's original name
  2. Extract all images from the PDF document
  3. Save images to an images/ subdirectory within the document folder
  4. Update markdown references to use the simple path images/img-X.jpeg
  5. Preserve image IDs from Mistral OCR (e.g., img-0.jpeg, img-1.jpeg)
  6. Save the markdown file in the document folder alongside the images

Directory structure after conversion with images:```
output/
└── research_paper/
├── research_paper.md
└── images/
├── img-0.jpeg
├── img-1.jpeg
└── img-2.jpeg


Each PDF conversion creates its own folder containing:
- The markdown file (same name as PDF + `.md`)
- An `images` subfolder with all extracted images

**Markdown output with images:**```markdown

# Document Title

Here is a chart showing the results:

![img-0.jpeg](images/img-0.jpeg)

The data shows...

Image references use the simple relative path images/img-X.jpeg, which works reliably in all markdown viewers.

Image format:
- Images are extracted from base64-encoded data URIs in the OCR response
- The base64 data is decoded and saved as binary image files
- Saved in their original format (typically JPEG or PNG)
- Markdown references are automatically updated to use relative paths
- Can be viewed directly in markdown viewers that support relative paths

How it works:
1. Creates a folder with the PDF's original name in the output directory
2. Mistral OCR returns images as base64-encoded data URIs (e.g., data:image/jpeg;base64,/9j/4AAQ...)
3. The server extracts the base64 portion, decodes it to binary data
4. Saves each image with its ID as the filename (e.g., img-0.jpeg) in the images/ subfolder
5. Updates markdown to reference images using the simple relative path images/img-X.jpeg
6. Saves the markdown file in the same folder as the images

Note: Image extraction increases processing time and API response size. Only enable when you need to preserve visual elements like charts, diagrams, photos, or illustrations from the PDF.

Limitations

  • PDF files must be under 50 MB
  • Maximum 1000 pages per request
  • Supported file format: PDF only

Pricing

Mistral OCR costs $1 per 1000 pages ($0.001 per page). Check Mistral's pricing page for current rates.

Troubleshooting

"MISTRAL_API_KEY environment variable is required"

Make sure you've created a .env file with your API key or set the environment variable in your MCP client configuration.

"File not found" error

Ensure the PDF file path is absolute and the file exists. On Windows, use double backslashes or forward slashes in paths.

Permission errors

Make sure the output directory exists and is writable. The server will attempt to create it if it doesn't exist.

VS Code not showing images in markdown preview

If images aren't displaying in VS Code's markdown preview:

  1. Check file structure: The new folder structure keeps everything organized:output/ └── document_name/ ├── document_name.md └── images/ ├── img-0.jpeg └── img-1.jpeg

  2. Verify image paths: Open the markdown file and check the image references:
    - Should be: ` - Uses simpleimages/path (not complex folder names with spaces) - Uses forward slashes/(not backslashes`)
    - Path is relative to the markdown file

  3. Open the document folder: Navigate into the document folder (e.g., output/document_name/) and open the markdown file from there. VS Code resolves relative paths from the markdown file's location.

  4. Check actual image files exist: Navigate to the images/ subfolder and verify the .jpeg files are there and can be opened.

  5. Restart VS Code: Sometimes VS Code's markdown preview cache needs refreshing. Close and reopen VS Code or run "Developer: Reload Window" from the command palette.

The simplified folder structure with images/ avoids issues with spaces and special characters in paths.

Development

Project structure```

mistral-ocr-mcp/
├── mistral_ocr_mcp/
│ ├── init.py
│ └── server.py # Main MCP server implementation
├── pyproject.toml # UV project configuration
├── .env.example # Example environment variables
├── .gitignore
└── README.md


### Running tests```bash
# Install dev dependencies
uv sync --dev

# Run tests (when added)
uv run pytest

License

MIT

References

  • Mistral OCR Documentation
  • Model Context Protocol
  • UV Package Manager

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Mistral Ocr MCP 0f351ee4 怎么安装?

在客户端按下面的安装命令接入:uvx --from . mistral-ocr-mcp。装完在客户端配置里引用同一个包或端点。

Mistral Ocr MCP 0f351ee4 怎么在 Claude Desktop、Claude、VS Code 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Mistral Ocr MCP 0f351ee4 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Mistral Ocr MCP 0f351ee4 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Mistral Ocr MCP 0f351ee4 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Mistral Ocr MCP 0f351ee4 能提供哪些能力?

资料显示约 2 个工具;能力标签包括 PDF处理、文档转换、Python、Claude。具体工具清单以官方文档为准。

Mistral Ocr MCP 0f351ee4 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Mistral Ocr MCP 0f351ee4 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。