[![Downloads](https://img.shields.io/pypi/dm/mcp-pandoc.svg)](https://pypi.python.org/pypi/mcp-pandoc) [![CI](https://github.com/vivekVells/mcp-pandoc/actions/workflows/ci.yml/badge.svg)](https://github.com/vivekVells/mcp-pandoc/actions/workflows/ci.yml)
![image](https://github.com/user-attachments/assets/10f18317-58e7-430e-9aec-b706b60fe2c6) [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/vivekvells-mcp-pandoc-badge.png)](https://mseep.ai/app/vivekvells-mcp-pandoc)

# mcp-pandoc: A Document Conversion MCP Server > Officially included in the [Model Context Protocol servers](https://github.com/modelcontextprotocol/servers/blob/main/README.md) open-source project. 🎉 ## Overview A Model Context Protocol server for document format conversion using [pandoc](https://pandoc.org/index.html). This server provides tools to transform content between different document formats while preserving formatting and structure. Please note that mcp-pandoc is currently in early development. PDF support is under development, and the functionality and available tools are subject to change and expansion as we continue to improve the server. Credit: This project uses the [Pandoc Python package](https://pypi.org/project/pandoc/) for document conversion, forming the foundation for this project. ## 📋 Quick Reference **New to mcp-pandoc?** Check out **[📖 CHEATSHEET.md](CHEATSHEET.md)** for - ⚡ Copy-paste examples for all formats - 🔄 Bidirectional conversion matrix - 🎯 Common workflows and pro tips - 🌟 Reference document styling guide _Perfect for quick lookups and getting started fast!_ ## Demo [![mcp-pandoc - v1: Seamless Document Format Conversion for Claude using MCP server](https://img.youtube.com/vi/vN3VOb0rygM/maxresdefault.jpg)](https://youtu.be/vN3VOb0rygM) > 🎥 [Watch on YouTube](https://youtu.be/vN3VOb0rygM)

Development/Unpublished Servers Configuration

ℹ️ Replace with your locally cloned project path ```bash "mcpServers": { "mcp-pandoc": { "command": "uv", "args": [ "--directory", "/mcp-pandoc", "run", "mcp-pandoc" ] } } ```

b) Published Servers Configuration - Consumers should use this config ```bash "mcpServers": { "mcp-pandoc": { "command": "uvx", "args": [ "mcp-pandoc" ] } } ``` - If you face any issue, use the "Published Servers Configuration" above directly instead of this cli. **Note**: To use locally configured mcp-pandoc, follow "Development/Unpublished Servers Configuration" step above. ## Development ### Testing To run the comprehensive test suite and validate all supported bidirectional conversions, use the following command: ```bash uv run pytest tests/test_conversions.py ``` This ensures backward compatibility and verifies the tool's core functionality. ### Building and Publishing To prepare the package for distribution: 1. Sync dependencies and update lockfile: ```bash uv sync ``` 2. Build package distributions: ```bash uv build ``` This will create source and wheel distributions in the `dist/` directory. 3. Publish to PyPI: ```bash uv publish ``` Note: You'll need to set PyPI credentials via environment variables or command flags: - Token: `--token` or `UV_PUBLISH_TOKEN` - Or username/password: `--username`/`UV_PUBLISH_USERNAME` and `--password`/`UV_PUBLISH_PASSWORD` ### Debugging Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector). You can launch the MCP Inspector via [`npm`](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) with this command: ```bash npx @modelcontextprotocol/inspector uv --directory /Users/vivekvells/Desktop/code/ai/mcp-pandoc run mcp-pandoc ``` Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging. --- ## Contributing We welcome contributions to enhance mcp-pandoc! Here's how you can get involved: 1. **Report Issues**: Found a bug or have a feature request? Open an issue on our [GitHub Issues](https://github.com/vivekVells/mcp-pandoc/issues) page. 2. **Submit Pull Requests**: Improve the codebase or add features by creating a pull request. ---

Mcp Pandoc

Install

Mcp Pandoc

Install