shuck-convert
Convert between document formats — DOCX/PDF to Markdown, Markdown to DOCX.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
shuck-convertclaude mcp add shuck-convert -- uvx shuck-convert==1.0.0
{
"mcpServers": {
"shuck-convert": {
"command": "uvx",
"args": [
"shuck-convert==1.0.0"
]
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
shuck-convert
Convert between document formats — DOCX/PDF to Markdown, Markdown to DOCX.
An MCP server for AI agents, with CLI support.
Tools
| Tool | Direction | Description |
|---|---|---|
doc_to_markdown | DOCX/PDF → MD | Extract text, formatting, tables, images |
markdown_to_docx | MD → DOCX | Academic 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
Questions fréquentes
Qu'est-ce que shuck-convert ?
Convert between document formats — DOCX/PDF to Markdown, Markdown to DOCX.
Comment installer shuck-convert ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add shuck-convert -- uvx shuck-convert==1.0.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour shuck-convert ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
shuck-convert est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient shuck-convert ?
Il est publié par Shan-Zhu. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.