Converts PDF files into Markdown so agents can read and reuse document content.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add pdf2md --env MINERU_API_KEY='<MINERU_API_KEY>' -- uv --directory C:pathtomcp-pdf2md run pdf2md --output-dir C:pathtooutput~/.codex/config.toml
[mcp_servers.pdf2md]
command = "uv"
args = ["--directory", "C:pathtomcp-pdf2md", "run", "pdf2md", "--output-dir", "C:pathtooutput"]
env = { MINERU_API_KEY = "<MINERU_API_KEY>" }
# codex mcp add pdf2md --env MINERU_API_KEY='<MINERU_API_KEY>' -- uv --directory C:pathtomcp-pdf2md run pdf2md --output-dir C:pathtooutput~/.cursor/mcp.json
{
"mcpServers": {
"pdf2md": {
"command": "uv",
"args": [
"--directory",
"C:pathtomcp-pdf2md",
"run",
"pdf2md",
"--output-dir",
"C:pathtooutput"
],
"env": {
"MINERU_API_KEY": "<MINERU_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"pdf2md": {
"type": "stdio",
"command": "uv",
"args": [
"--directory",
"C:pathtomcp-pdf2md",
"run",
"pdf2md",
"--output-dir",
"C:pathtooutput"
],
"env": {
"MINERU_API_KEY": "<MINERU_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"pdf2md": {
"command": "uv",
"args": [
"--directory",
"C:pathtomcp-pdf2md",
"run",
"pdf2md",
"--output-dir",
"C:pathtooutput"
],
"env": {
"MINERU_API_KEY": "<MINERU_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"pdf2md": {
"command": "uv",
"args": [
"--directory",
"C:pathtomcp-pdf2md",
"run",
"pdf2md",
"--output-dir",
"C:pathtooutput"
],
"env": {
"MINERU_API_KEY": "<MINERU_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"pdf2md": {
"command": "uv",
"args": [
"--directory",
"C:pathtomcp-pdf2md",
"run",
"pdf2md",
"--output-dir",
"C:pathtooutput"
],
"env": {
"MINERU_API_KEY": "<MINERU_API_KEY>"
}
}
}
}Environment variables
MINERU_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.