内容
# MCP MarkitDown Base
这是一个基于 `MarkItDown` 库的 MCP (Multi-Agent Communication Protocol) 服务，用于将各种文件格式转换为 Markdown 文本。
## 功能
- 将指定文件转换为 Markdown 格式的文本。
- 支持多种文件格式，包括 PDF、PowerPoint、Word、Excel、Images (EXIF metadata and OCR)、Audio (EXIF metadata and speech transcription)、HTML、Text-based formats (CSV, JSON, XML)、ZIP files (iterates over contents)、Youtube URLs、EPubs。
- 可选择将转换后的 Markdown 文本保存到指定路径。
## 安装
1. 克隆仓库：
```bash
git clone https://gitee.com/mcp-markitdown-base.git
```
## 使用
该服务通过 MCP 协议提供 `convertFileToMarkdown` 工具。您可以通过 MCP 客户端调用此工具。
### `convertFileToMarkdown` 工具
- **描述**：根据传入的文件路径，将文件转换为 markdown 格式，并返回转换后的 markdown 文本。
- **参数**：
- `file` (str): 文件路径，根据系统写绝对路径。
- `resultPath` (str): 转换后的 markdown 文本保存路径，默认传入空字符串 `""` 即可。如果明确要求路径则根据系统写绝对路径。
### 示例 (通过 MCP 客户端调用)
MCP 客户端配置示例(Windows)
以下是一个 MCP 客户端的配置示例，用于启动此服务：
```json
{
"mcpServers": {
"mcp-markitdown-base": {
"command": "uv",
"args": [
"run",
"--directory",
"E:\\mcp-markitdown-base",
"main.py"
]
}
}
}
```
请将 `E:\\mcp-markitdown-base` 替换为您的项目实际路径，并确保路径中的反斜杠 `\` 已正确转义为 `\\`。
MCP 市场