文件转换服务

MCP (Model Context Protocol) 服务器用于将 PDF、DOCX、XLSX、图片等 20 多种格式的文件转换为 Markdown 或 JSON 格式。

  • by takltc
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 takltc/markdown-new-mcp

使用说明

降价新mcp

MCP(模型上下文协议)服务器 markdown.new 文件转换API。将PDF、DOCX、XLSX、图像和20多种格式转换为Markdown。

安装

npm install markdown-new-mcp

用法

使用克劳德桌面或克劳德代码

对于stdio MCP客户端,请使用 npx -y 因此服务器在Node.js下启动并保留JSON-RPC stdio流。将此添加到您的Claude配置中:

{
  "mcpServers": {
    "markdown-new": {
      "command": "npx",
      "args": ["-y", "markdown-new-mcp@latest"]
    }
  }
}

使用opencode

将此添加到 mcp 部分 ~/.config/opencode/opencode.json:

{
  "mcp": {
    "markdown-new": {
      "type": "local",
      "command": ["npx", "-y", "markdown-new-mcp@latest"]
    }
  }
}

带API密钥(可选)

对于更高的速率限制,您可以通过环境变量提供API密钥:

{
  "mcpServers": {
    "markdown-new": {
      "command": "npx",
      "args": ["-y", "markdown-new-mcp@latest"],
      "env": {
        "MARKDOWN_NEW_API_KEY": "mk_your_api_key_here"
      }
    }
  }
}

可选:

  • MARKDOWN_NEW_TIMEOUT_MS:上游API调用的请求超时(以毫秒为单位)(默认值: 30000)

可用工具

convert_url_to_markdown

将远程文件URL转换为干净的Markdown文本。支持PDF、DOCX、XLSX、图像和20多种格式。

参数:

  • url (字符串,必填):远程文件的HTTP或HTTPS URL
  • api_key (字符串,可选):API键,用于更高的速率限制;服务器还读取 MARKDOWN_NEW_API_KEY

例子:

Convert this PDF to markdown: https://example.com/document.pdf

convert_file_to_markdown

将本地文件转换为干净的Markdown文本。路径必须是绝对的,并且对服务器进程可见。支持PDF、DOCX、XLSX、图像和20多种格式。

参数:

  • file_path (string,必填):本地文件的绝对路径
  • api_key (字符串,可选):API键,用于更高的速率限制;服务器还读取 MARKDOWN_NEW_API_KEY

例子:

Convert /path/to/document.pdf to markdown

convert_url_to_json

将远程文件URL转换为结构化JSON,包括标题、令牌和持续时间等元数据。支持PDF、DOCX、XLSX、图像和20多种格式。

参数:

  • url (string,必填):远程文件的URL
  • api_key (字符串,可选):API键,用于更高的速率限制;服务器还读取 MARKDOWN_NEW_API_KEY

支持格式

  • 文件: PDF、DOCX、ODT
  • 电子表格: XLSX、XLS、XLSM、XLSB、ET、ODS、数字
  • 图像: JPG、JPEG、PNG、WebP、SVG
  • 文本/数据: TXT、MD、CSV、JSON、XML、HTML、HTM

限制

  • 没有API密钥: 每个IP每天500个请求
  • 使用API密钥: 可用更高的限制
  • 最大文件大小: 10MB

发展

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm run dev

# Smoke test the stdio MCP server
npm run build
npm run smoke:stdio -- node dist/index.js

许可证

麻省理工学院