English Français العربية

shuck-convert

السجل الرسمي الإنتاجية

Convert between document formats — DOCX/PDF to Markdown, Markdown to DOCX.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package shuck-convert
Claude Code 
claude mcp add shuck-convert -- uvx shuck-convert==1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "shuck-convert": {
            "command": "uvx",
            "args": [
                "shuck-convert==1.0.0"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. shuck-convert
  2. Tools
  3. Prerequisites
  4. Install
  5. Usage
  6. License

shuck-convert

Convert between document formats — DOCX/PDF to Markdown, Markdown to DOCX.

An MCP server for AI agents, with CLI support.

Tools

ToolDirectionDescription
doc_to_markdownDOCX/PDF → MDExtract text, formatting, tables, images
markdown_to_docxMD → DOCXAcademic styling: Times New Roman + SimSun, three-line tables

Prerequisites

  • Python 3.10+
  • Pandoc (required for markdown_to_docx)

Install

pip install shuck-convert

Or from source:

git clone https://github.com/Shan-Zhu/shuck-convert.git
cd shuck-convert
pip install -e .

Usage

MCP Server (for AI agents)

Add to your MCP client config:

{
  "mcpServers": {
    "shuck-convert": {
      "command": "shuck-convert",
      "args": [],
      "transportType": "stdio"
    }
  }
}

Or with uvx:

{
  "mcpServers": {
    "shuck-convert": {
      "command": "uvx",
      "args": ["shuck-convert"],
      "transportType": "stdio"
    }
  }
}
CLI
# DOCX/PDF to Markdown
shuck-convert doc2md report.docx
shuck-convert doc2md paper.pdf

# Markdown to DOCX
shuck-convert md2docx paper.md
Development
pip install -e .
fastmcp dev src/shuck_convert/server.py

License

MIT

الأسئلة الشائعة

ما هو shuck-convert؟

Convert between document formats — DOCX/PDF to Markdown, Markdown to DOCX.

كيف أثبّت shuck-convert؟

يعمل على جهازك. في Claude Code: claude mcp add shuck-convert -- uvx shuck-convert==1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج shuck-convert إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل shuck-convert مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون shuck-convert؟

ينشره Shan-Zhu. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.