Log inSubmit server
Convertisseur Ia logo

Convertisseur Ia

Converts local documents into lightweight Markdown and estimates token savings through a local MCP server.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Convertisseur Ia

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "convertisseur-ia": {
      "command": "npx",
      "args": [
        "-y",
        "convertisseur-ia-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command didn't complete successfully in our automated test.

npx -y convertisseur-ia-mcp

.2.0 npm notice Changelog: <https://github.com/npm/cli/releases/tag/v12.2.0> npm notice Run `npm install -g npm@12.2.0` to update! npm notice npm ERR! code ERR_SSL_CIPHER_OPERATION_FAILED npm ERR! 404C4565637F0000:error:1C800066:Provider routines:ossl_gcm_stream_update:cipher operation failed:../deps/openssl/openssl/providers/implementations/ciphers/ciphercommon_gcm.c:320: npm ERR! npm ERR! A complete log of this run can be found in: /home/user/.npm/_logs/2026-10-18T11_31_00_427Z-debug-0.log

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 5d ago.

Overview

The convertisseur-ia MCP server converts local documents into lightweight Markdown and reports estimated token usage. It supports text-based PDFs, Office files, CSV, HTML, JSON, XML, RTF, TXT, and code through a Node.js stdio process, with no network calls. Use it when an MCP client needs to inspect document content while reducing the amount of text sent to an AI model.

Use cases

  • Convert a text-based PDF into compact Markdown
  • Preview a document before sending it to an AI model
  • Convert a directory into one Markdown context file
  • Save converted Markdown beside the source document

Key features

  • Converts supported local files to lightweight Markdown
  • Estimates token usage before and after conversion
  • Processes individual files or complete directories
  • Supports page ranges, character limits, filters, and recursion
  • Writes Markdown output beside the original file
  • Runs offline through Node.js and MCP stdio

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

8/8 checks healthy over the last 42d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · convertisseur-ia-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads110Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Install checkInconclusiveInstall command did not finish in our automated test.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Convertisseur Ia works

What convertisseur-ia MCP server does

The convertisseur-ia MCP server reads files from the local filesystem and turns supported documents into compact Markdown for use in an MCP conversation. It is intended for documents that already contain a text layer or structured text, rather than scanned pages that require optical character recognition. Supported inputs include text-based PDF files, DOCX, XLSX, PPTX, CSV, HTML, JSON, XML, RTF, TXT, and source code.

The conversion process also estimates token usage. This lets an agent compare the approximate size of the original content with the lighter Markdown result before sending more material into a conversation. The server operates locally: files are read from disk, converted in memory, and no network request is made.

How it works

The server runs as a Node.js MCP process using standard input and output. For Office Open XML files such as DOCX, XLSX, and PPTX, it reads the ZIP package and converts the contained XML into Markdown without requiring a separate Office installation. PDF text is extracted with pdf.js, with an integrated fallback when that library is unavailable.

PDF files are checked for a usable text layer. If a PDF is identified as scanned, the conversion tool reports that it should be handled by the separate ocr-images server. That companion server uses Windows OCR and is not part of the document conversion tools described here.

Token figures are estimates rather than billing measurements. Text is approximated at about four characters per token, while image estimates use width multiplied by height divided by 750.

Setup and configuration

Node.js 18 or newer is required, and the converter is described as cross-platform. The published package can be started with npx -y convertisseur-ia-mcp. A source checkout can instead be installed with npm install from the convertisseur-ia directory.

Add the process to an MCP client's mcpServers configuration with npx as the command and -y convertisseur-ia-mcp as its arguments. The client must be restarted after changing its configuration. The project names Claude Desktop, Claude Code, Cursor, VS Code, and LM Studio as clients that can be configured this way.

Tools and capabilities

The convertisseur-ia MCP server exposes five tools:

  • convertir_document converts one file to Markdown and returns token statistics. It accepts character limits and optional starting and ending pages.
  • apercu_document returns a low-cost preview containing the detected type, file size, estimated tokens, and initial characters.
  • convertir_dossier combines a directory's files into one Markdown result. Filtering, recursion, and a maximum file count can be specified.
  • enregistrer_markdown converts a file and writes a .md file beside the source by default.
  • formats_supportes lists recognized formats and relevant exceptions.

Limitations and notes

The convertisseur-ia MCP server reads any local file path that the trusted MCP client asks it to read; it does not impose a directory restriction. It should therefore be exposed only to a trusted client and not placed behind a public service.

Only enregistrer_markdown writes output files among these tools. Older binary Office formats such as DOC, XLS, and PPT are rejected and need to be saved as DOCX, XLSX, or PPTX first. Scanned PDFs need the separate OCR workflow. The MIT-licensed project also notes that conversion output and token counts should be treated as estimates for practical use.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Convertisseur Ia

convertisseur-ia is an MCP server that connects an MCP client to local documents on disk. Its main tools convert individual files or folders into lightweight Markdown, preview files, save Markdown beside originals, and list supported formats. It runs through Node.js, uses stdio, and performs conversion without network calls.

Install it by running `npx -y convertisseur-ia-mcp` and adding that command to the MCP client's `mcpServers` configuration. Node.js 18 or newer is required. You can also clone the repository, enter the `convertisseur-ia` directory, and run `npm install`.

It supports text-based PDF, DOCX, XLSX, PPTX, CSV, HTML, JSON, XML, RTF, TXT, and code files. Older binary DOC, XLS, and PPT files are not supported and should be saved in their newer Office formats first.

No, scanned PDFs should be processed with the separate `ocr-images` server. `convertir_document` detects PDFs without a text layer and directs the workflow to `ocr_pdf`, which uses Windows OCR and is intended for Windows 10 or 11.

Yes, Cursor is named as a compatible MCP client in the project instructions. Configure the server with `npx -y convertisseur-ia-mcp` in Cursor's MCP settings and restart the client after saving the configuration.

Related MCP servers

All in Workplace & Productivity All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewConvertisseur Ia AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/convertisseur-ia?style=directory)](https://allmcps.com/mcp/convertisseur-ia)
HTML Embed
<a href="https://allmcps.com/mcp/convertisseur-ia"><img src="https://allmcps.com/api/badge/convertisseur-ia?style=directory" alt="Convertisseur Ia on AllMCPs" /></a>