magicconvert MCP server

MagicConvert MCP 服务器

A. 模型上下文协议（MCP） 服务器，使用 MagicConvert 图书馆。输出以干净、结构化的方式交付 降价 格式。

______________________________________________________________________

🌟 特性

• ✅ 文档转换:

- 字 .docx - 可移植文档格式 .pdf - 幻灯片 .pptx - Excel .xlsx - CSV文件 .csv

• 🖼️ 图像OCR:

- JPEG图像 .jpg, .jpeg - 便携式网络图形 .png - 标签式图像文件格式 .tiff - 位图 .bmp

• 🌐 Web内容到Markdown:

- URL(http://, https://) - 一项 .html, .htm

• ✍️ 文本转换:

- 纯文本 - 超文本标记语言 - CSV文件

• 🧩 灵活的输入选项:

- 本地文件路径 - Base64编码上传 - 直接URL - 原始文本输入

• 🧼 清洁输出:

- 结构良好、可读的Markdown输出

• 🔁 临时文件处理:

- 安全和自动的临时文件创建和清理

______________________________________________________________________

🚀 安装

先决条件

安装核心库：

pip install magicconvert

安装MCP服务器包：

pip install magicconvert-mcp-server

______________________________________________________________________

与一起跑步 uvx （推荐）

在MCP配置中添加服务器(mcp.yaml 或 .mcp/config.json):

{
  "mcpServers": {
    "magicconvert": {
      "command": "uvx magicconvert-mcp-server"
    }
  }
}

然后运行服务器：

uvx magicconvert-mcp-server

______________________________________________________________________

🛠️ 支持的工具

服务器通过MCP公开以下工具：

1. convert_file_to_markdown

描述：将文件从本地文件系统转换为Markdown。

{
  "file_path": "/path/to/your/file.pdf"
}

______________________________________________________________________

2. convert_base64_file_to_markdown

描述：接受base64编码的文件（来自上传）并对其进行转换。

{
  "base64_data": "base64string==",
  "filename": "document.pdf"
}

______________________________________________________________________

3. convert_url_to_markdown

描述：从URL下载网页或文档并对其进行转换。

{
  "url": "https://example.com/article"
}

______________________________________________________________________

4. convert_text_to_markdown

描述：将原始文本内容转换为Markdown。支持纯文本、HTML和CSV。

{
  "text_content": "
Hello
",
  "format_type": "html"
}

接受 format_type 值：

• plain （默认）
• html
• csv

______________________________________________________________________

5. get_supported_formats

描述：返回支持的输入类型和功能的Markdown格式列表。

无需参数。

______________________________________________________________________

📦 示例用法

from mcp.client import Client

client = Client()

response = client.call_tool("magicconvert", "convert_file_to_markdown", {
    "file_path": "example.pdf"
})

print(response[0].text)

______________________________________________________________________

🔒 临时文件管理

所有创建的临时文件（例如，用于base64或文本输入）都是：

• 存储在平台安全的临时目录中（例如。， /tmp, %TEMP%)
• 转换后自动清理
• 经过路径安全验证

______________________________________________________________________

⚙️ 日志记录

服务器将消息记录到 mcp_magicconvert_server 记录仪。

要启用调试日志记录，请设置环境变量：

export LOGLEVEL=DEBUG

______________________________________________________________________

🧪 开发与测试

克隆存储库并运行：

python -m magicconvert_mcp_server

要使用stdio传输（MCP）运行：

uvx magicconvert-mcp-server

要通过CLI进行测试，MCP兼容客户端如 mcp[cli] 推荐。

______________________________________________________________________

📚 高级：MCP集成

此库设计用于 MCP兼容环境例如：

• OpenAI的API调用工具
• 带MCP扩展的LangChain或LlamaIdex
• 自定义MCP客户端实现

______________________________________________________________________

🧠 内部概述

服务器定义：

• A. MagicConvertProcessor 环绕核心 MagicConvert 逻辑
• 完全支持异步base64解码 aiofiles
• 通过文件名和扩展名进行智能MIME推理
• 模块化 Server 类使用 mcp 具有定义工具接口的框架

______________________________________________________________________

📄 许可证

MIT许可证。看 许可证 了解详情。

______________________________________________________________________

🔗 链接

• PyPI： magicconvert-mcp-服务器
• 核心库： MagicConvert 的
• MCP协议： mcp规范