md-pdf-mcp

md-pdf-mcp (Markdown から PDF への MCP サーバー)

VS Code のマークダウン スタイルと Python の ReportLab を使用して、Markdown を美しくスタイル設定された PDF に変換します。

コンポーネント

リソース

サーバーは、次の機能を備えたシンプルなメモ保存システムを実装します。

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

プロンプト

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

• 要約ノート: 保存されているすべてのノートの要約を作成します
  • 詳細レベル（簡潔/詳細）を制御するためのオプションの「スタイル」引数
  • 現在のすべてのメモをスタイルの好みに合わせて組み合わせたプロンプトを生成します

ツール

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

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

構成

[TODO: 実装に固有の構成の詳細を追加する]

クイックスタート

インストール

クロードデスクトップ

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

発達

建築と出版

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

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

2. パッケージディストリビューションをビルドします。

これにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。

3. PyPI に公開:

注: 環境変数またはコマンド フラグを使用して PyPI 資格情報を設定する必要があります。

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

デバッグ

MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。

次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。

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