OpenFormatDB
Identify a file, look up its format and convert it locally with WebAssembly engines
- 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/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"openformatdb": {
"command": "npx",
"args": [
"-y",
"@openformatdb/mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"openformatdb": {
"command": "npx",
"args": [
"-y",
"@openformatdb/mcp"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools