md-pdf-mcp (Markdown to PDF MCP Server)

md-pdf-mcp（Markdown から PDF への MCP サーバー）

VS Code の Markdown スタイルと Python の ReportLab を使って、美しくスタイル設定された PDF に Markdown を変換します。

コンポーネント

リソース

このサーバーは、シンプルなメモ保存システムを実装しています。

• 個々のメモにアクセスするためのカスタム note:// URI スキーム
• 各メモリソースには、名前、説明、text/plain MIME タイプがあります

プロンプト

このサーバーは、単一のプロンプトを提供します。

• summarize-notes：保存されているすべてのメモの要約を作成します
  • 詳細度（brief/detailed）を指定する任意の「style」引数
  • 現在のすべてのメモとスタイルの設定を組み合わせたプロンプトを生成します

ツール

このサーバーは、1 つのツールを実装しています。

• add-note：サーバーに新しいメモを追加します
  • 必須の文字列引数として「name」と「content」を受け取ります
  • サーバーの状態を更新し、リソースの変更をクライアントに通知します

設定

[TODO: Add configuration details specific to your implementation]

クイックスタート

インストール

Claude Desktop

MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

開発版／未公開サーバーの設定

``` "mcpServers": { "md-pdf-mcp": { "command": "uv", "args": [ "--directory", "/Users/path/to/your/local/md-pdf-mcp", "run", "md-pdf-mcp" ] } } ```

公開済みサーバーの設定

``` "mcpServers": { "md-pdf-mcp": { "command": "uvx", "args": [ "md-pdf-mcp" ] } } ```

開発

ビルドと公開

パッケージを配布用に準備するには：

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 の使用を強くおすすめします。

次のコマンドを使い、npm から MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory /Users/seanivore/Development/md-pdf-mcp run md-pdf-mcp

起動すると、ブラウザーでアクセスできる URL が Inspector に表示され、デバッグを開始できます。