File Format Converter (Pandoc)

🚀 MCP - Pandoc 説明ドキュメント

MCP - Pandoc は、ファイル形式の変換に特化したツールです。様々な形式間の変換をサポートしており、ユーザーは内容やファイルパスを指定することで、テキストやファイルを PDF、Markdown、HTML などの形式に変換できます。

🚀 クイックスタート

MCP - Pandoc を使うことで、簡単にファイル形式を変換できます。以下では、そのインストール方法や開発に関するガイドを紹介します。

✨ 主な機能

• 複数のファイル形式間の変換をサポート。
• ユーザーは内容またはファイルパスを指定することで、PDF、Markdown、HTML などの形式に変換可能。

📦 インストール

方法一：設定ファイルを通じた手動インストール

• MacOS では ~/Library/Application\ Support/Claude/claude_desktop_config.json ファイルを開きます。
• Windows では %APPDATA%/Claude/claude_desktop_config.json ファイルにアクセスします。

"mcpServers": {
  "mcp-pandoc": {
    "command": "uv",
    "args": [
      "--directory",
      "<DIRECTORY>/mcp-pandoc",
      "run",
      "mcp-pandoc"
    ]
  }
}

"mcpServers": {
  "mcp-pandoc": {
    "command": "uvx",
    "args": [
      "mcp-pandoc"
    ]
  }
}

方法二：Smithery を通じた公開済みサーバー設定の自動インストール

以下の bash コマンドを実行すると、Smithery を自動的に使用して、公開済みの MCP - Pandoc PyPI サービスをインストールできます。

npx -y @smithery/cli install mcp-pandoc --client claude

⚠️ 重要提示

ローカル設定の mcp - pandoc を使用する場合は、上記の「開発/未公開のサーバー設定」のセクションを参照してください。

📚 ドキュメント

構築と公開

パッケージを配布する準備をするには、以下の手順を実行します。

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. リリースバージョンを構築します。

uv build

これにより、dist/ ディレクトリにソースコードとホイール形式のリリースパッケージが作成されます。

3. PyPI に公開します。

uv publish

⚠️ 重要提示

PyPI の認証情報を環境変数またはコマンドライン引数で設定する必要があります。

• トークン: --token または UV_PUBLISH_TOKEN
• またはユーザー名/パスワード: --username/UV_PUBLISH_USERNAME と --password/UV_PUBLISH_PASSWORD

デバッグガイド

MCP サーバーは標準入出力で動作するため、デバッグが難しい場合があります。最適なデバッグ体験を得るために、MCP Inspector の使用を強くおすすめします。

以下のコマンドで MCP Inspector を起動できます。

<Inspector 起動命令>

🔧 貢献ガイド

もしあなたがこのプロジェクトに貢献したい場合は、貢献ドキュメント を参照して、開発への参加方法やコードの提出方法を確認してください。

このドキュメントでは、MCP - Pandoc の基本機能、インストール方法、開発設定などの情報を提供しており、ユーザーがこのツールをすぐに使い始めるのに役立つことを目指しています。