Skip to content
MCP server

OpenFormatDB

Identify a file, look up its format and convert it locally with WebAssembly engines

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Linux, macOS
Runs
Locally
Version
0.3.0
Listing updated
3 days ago

About OpenFormatDB

OpenFormatDB is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

Before an agent writes a parser or reverse engineers a file, this server tells it what the file probably is and what software already handles it. identify_file ranks candidate formats from the first bytes, MIME type and extension, and the agent reads the bytes itself so the file never leaves the machine. lookup_format and search_formats return records with identifiers (including PRONOM and Wikidata ids), open-source software first, grammars, specifications and versions.

find_conversion returns the cheapest chains of open tools between two formats, lossless first, with each step's command and what is lost. convert_file runs conversions locally with ImageMagick, resvg, FFmpeg, Pandoc, 7-Zip, GDAL and Assimp compiled to WebAssembly. Engines of 2 to 59 MB are downloaded once, pinned and SHA-256 checked, and output is written next to the input without overwriting.

Two write tools, claim_format and publish_findings, edit YAML records in a repository checkout and print the git commands for a pull request; they never run git. Text is screened against a policy that excludes DRM removal, keys and copies of paywalled standards. Without a checkout the server reads the site's static API read-only. It needs Node 22.18 or later.

Install

Run in a terminal

claude mcp add openformatdb -- npx -y @openformatdb/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "openformatdb": {
      "command": "npx",
      "args": [
        "-y",
        "@openformatdb/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "openformatdb": {
      "command": "npx",
      "args": [
        "-y",
        "@openformatdb/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "openformatdb": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@openformatdb/mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "openformatdb": {
      "command": "npx",
      "args": [
        "-y",
        "@openformatdb/mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "openformatdb": {
      "command": "npx",
      "args": [
        "-y",
        "@openformatdb/mcp"
      ]
    }
  }
}

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

identify_file
Candidate formats from the first bytes, MIME type and name
lookup_format
Full record: identifiers, software, grammars, specification, family and versions, claims, advice
search_formats
Search by name, alias, extension, MIME type, PRONOM or Wikidata id
find_conversion
Cheapest chains of open tools between two formats, with commands and losses
convert_file
Converts a file locally with WebAssembly engines; nothing is uploaded
list_sources
Aggregated sources with counts, licences and snapshot dates
claim_format
Declares you are documenting a format for up to 90 days
publish_findings
Merges structure, grammars, tools, conversions and verification into the record

What it does

File identification
Ranks candidate formats from magic bytes, MIME type and extension.
Format records
Returns identifiers, software, grammars, specification and versions.
Conversion chains
Finds the cheapest chain of open tools with commands and losses.
Local conversion
Converts files with WebAssembly engines without uploading anything.
Claim a format
Reserves a format for up to 90 days so work is not duplicated.
Publish findings
Merges structure and tool findings into the record via a pull request.

Good for

  • Work out what an unknown file is before parsing it
  • Convert a file between formats without uploading it
  • Find open tools that read an obscure format
  • Contribute documentation for an undocumented format

Pricing

Open source

Free npm package

Prices change. Check openformatdb.org before you buy.

OpenFormatDB FAQ

Does the file get uploaded?

No. The agent reads the bytes locally and convert_file runs on your machine; only the engine's first download uses the network.

Which converters are used?

ImageMagick, resvg, FFmpeg, Pandoc, 7-Zip, GDAL and Assimp compiled to WebAssembly.

Can it overwrite my files?

No. Converted output is written next to the input and never overwrites.

How do I install it?

Run npx -y @openformatdb/mcp, or add it to Claude Code with claude mcp add.

Can it edit the database?

Only from a repository clone, where it edits YAML records and prints git commands for a pull request.

Is OpenFormatDB free?

Yes. OpenFormatDB is open source, so you can use and self-host it for free.

How do I add OpenFormatDB to Claude Code?

Run this command in your terminal: claude mcp add openformatdb -- npx -y @openformatdb/mcp

What are the best alternatives to OpenFormatDB?

The closest alternatives to OpenFormatDB are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to OpenFormatDB

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools