mdfi

● Active

io.github.TopTop-Oy/mdfi-connect

Read PDFs, scans and Office files page by page, with quality flags and CSV table export.

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "mdfi-connect": {
      "command": "uvx",
      "args": [
        "mdfi-connect"
      ],
      "env": {
        "MDFI_API_KEY": "<your MDFI_API_KEY>",
        "MDFI_API_URL": "https://api.mdfi.ai"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env MDFI_API_KEY='<your MDFI_API_KEY>' --env MDFI_API_URL=https://api.mdfi.ai --transport stdio mdfi-connect -- uvx mdfi-connect
OpenAI Codex CLI
codex mcp add mdfi-connect --env MDFI_API_KEY='<your MDFI_API_KEY>' --env MDFI_API_URL=https://api.mdfi.ai -- uvx mdfi-connect
VS Code
code --add-mcp '{"name":"mdfi-connect","type":"stdio","command":"uvx","args":["mdfi-connect"],"env":{"MDFI_API_KEY":"<your MDFI_API_KEY>","MDFI_API_URL":"https://api.mdfi.ai"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • MDFI_API_KEYrequiredsecretYour mdfi API key, from the Connect page of the dashboard (app.mdfi.ai)
  • MDFI_API_URLmdfi API address

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Documents & Knowledge
Version
0.1.1
Registry
active
Published
11/13/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 17, 2026

Looks healthy: mdfi is maintained, open source.

Maintained
Active
Last commit 7 days ago (Nov 15, 2026), 0 open issues.
Official registry
Active
Published as io.github.TopTop-Oy/mdfi-connect in the official MCP registry, version 0.1.1.
Source
Open source, Apache-2.0
Public repository under the Apache-2.0 licence, 1 stars, 0 forks.
Runs
On your machine
A local PyPI package started by your client; it can reach whatever your user account can.
Credentials
1 required
Declared environment variables: MDFI_API_KEY. They stay on your machine; the config on this page shows where each goes.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.

On GitHub

read Nov 15, 2026
Stars
1
Forks
0
Last push
Nov 15, 2026
License
Apache-2.0

Pythonclaude-codecursordocumentsmcpmcp-serverocrpdf

From the README

mdfi-connect MCP stdio server that lets coding agents (Claude Code, Cursor) read documents through the mdfi cloud API: PDFs and scans, Word, PowerPoint, Excel, HTML, email, images and text. Tables come back structured, anything uncertain is marked, and tables can be exported to CSV. Install Claude Code: claude mcp add mdfi --env MDFIAPIKEY=mdfi... --env MDFIAPI_URL=https://api.mdfi.ai -- uvx mdfi-connect Cursor (~/.cursor/mcp.json): { "mcpServers": { "mdfi": { "command": "uvx", "args": ["mdfi-connect"], "env": { "MDFIAPIKEY": "mdfi...", "MDFIAPI_URL": "https://api.mdfi.ai" } } } } Claude Code plugin (asks for your key when you install it and keeps it as a sensitive setting; runs the plugin's own locked project with uv run --locked): /plugin marketplace add TopTop-Oy/mdfi-connect /plugin install mdfi@mdfi Cursor plugin (once listed in the Cursor Marketplace): install mdfi and set MDFIAPIKEY under Plugins → Configure. The Connect page of your mdfi dashboard (https://app.mdfi.ai) shows these snippets with your key filled in.…

Read the full README on GitHub →

The most-starred Documents & Knowledge servers in the index, with their live-check result.

ServerStarsLast pushLive check
Context765,010Nov 2026Working
Codebase Memory48,994Nov 2026Local / not checked
Reactive Resume45,960Nov 2026Needs sign-in
Sui Knowledge Base (kapa.ai)7,785Nov 2026Needs sign-in
Agent-Native Slides7,735Nov 2026Needs sign-in

mdfi: questions people ask

Is mdfi a remote or a local MCP server?
According to its entry in the official MCP registry, mdfi ships as a local package (PyPI) that your client starts on your machine.
Does mdfi need an API key?
Its registry entry declares one required environment variable: MDFI_API_KEY. The config on this page shows where each goes.
Is mdfi safe to use?
Looks healthy: mdfi is maintained, open source. In detail — maintained: Active; official registry: Active; source: Open source, Apache-2.0; runs: On your machine; credentials: 1 required. Serverdex check of Nov 17, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is mdfi still maintained?
Active: the repository's last commit 7 days ago. Last push Nov 15, 2026, 1 GitHub stars, Apache-2.0 licence. Read from GitHub on Nov 15, 2026.
How do I add mdfi to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Documents & Knowledge →

Add the badge to your site

Show visitors that mdfi is listed here — it’s also the link we check for a free listing.

mdfi — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-toptop-oy-mdfi-connect?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="mdfi — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![mdfi — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-toptop-oy-mdfi-connect?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-toptop-oy-mdfi-connect) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-toptop-oy-mdfi-connect) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-toptop-oy-mdfi-connect)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-toptop-oy-mdfi-connect"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-toptop-oy-mdfi-connect"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-toptop-oy-mdfi-connect"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).