{
  "markdown": "# shuck-convert\n\n<!-- mcp-name: io.github.Shan-Zhu/shuck-convert -->\n\n[![PyPI](https://img.shields.io/pypi/v/shuck-convert)](https://pypi.org/project/shuck-convert/)\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io)\n\nConvert between document formats — DOCX/PDF to Markdown, Markdown to DOCX.\n\nAn MCP server for AI agents, with CLI support.\n\n## Tools\n\n| Tool | Direction | Description |\n|------|-----------|-------------|\n| `doc_to_markdown` | DOCX/PDF → MD | Extract text, formatting, tables, images |\n| `markdown_to_docx` | MD → DOCX | Academic styling: Times New Roman + SimSun, three-line tables |\n\n## Prerequisites\n\n- Python 3.10+\n- [Pandoc](https://pandoc.org/installing.html) (required for `markdown_to_docx`)\n\n## Install\n\n```bash\npip install shuck-convert\n```\n\nOr from source:\n\n```bash\ngit clone https://github.com/Shan-Zhu/shuck-convert.git\ncd shuck-convert\npip install -e .\n```\n\n## Usage\n\n### MCP Server (for AI agents)\n\nAdd to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"shuck-convert\": {\n      \"command\": \"shuck-convert\",\n      \"args\": [],\n      \"transportType\": \"stdio\"\n    }\n  }\n}\n```\n\nOr with uvx:\n\n```json\n{\n  \"mcpServers\": {\n    \"shuck-convert\": {\n      \"command\": \"uvx\",\n      \"args\": [\"shuck-convert\"],\n      \"transportType\": \"stdio\"\n    }\n  }\n}\n```\n\n### CLI\n\n```bash\n# DOCX/PDF to Markdown\nshuck-convert doc2md report.docx\nshuck-convert doc2md paper.pdf\n\n# Markdown to DOCX\nshuck-convert md2docx paper.md\n```\n\n### Development\n\n```bash\npip install -e .\nfastmcp dev src/shuck_convert/server.py\n```\n\n## License\n\nMIT\n",
  "bytes": 1604,
  "sha": "cb6c52ad79d9d092e3c979feab67eaa11c68e142eeaf51dff63a677f2326b2b7",
  "repo_slug": "shan-zhu/shuck-convert",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_shan_zhu_shuck_convert_d528e0a3/readme"
}