Mkslides MCP

🚀 mdslides-mcp-server

このサーバーは、mkslidesライブラリを使用して、MarkdownコンテンツからHTMLスライドを生成するMCP（モデルコンテキストプロトコル）サーバーです。

🚀 クイックスタート

このサーバーは、mkslidesコマンドラインツールに簡単なインターフェースを提供し、モデルコンテキストプロトコルを介してMarkdown入力から直接プレゼンテーションを生成できます。これにより、VSCode内のClaudeなどとの統合が容易になり、プレゼンテーションの作成と管理が簡単になります。

✨ 主な機能

• MarkdownからHTMLスライドを生成します。
• 複数のmkslides構成オプション（テーマ、構文ハイライトテーマ、Reveal.jsオプション）をサポートします。
• 一時ファイルを適切に処理します。
• Dockerを使用したコンテナ化されたデプロイオプションがあります。

📦 インストール

前提条件

• Python 3.12以上
• mkslidesがインストールされ、システムPATHに追加されていること
• モデルコンテキストプロトコル（MCP）クライアント（例：VSCode内のClaude）
• Docker（Dockerを使用するインストール方法の場合）

インストール方法

pipを使用する場合

1. リポジトリをクローンします：

git clone https://github.com/your-repo/mdslides-mcp-server.git # 実際のリポジトリURLに置き換えてください
cd mdslides-mcp-server

2. pipとuv（推奨）を使用してインストールします：

uv sync && uv run

Dockerを使用する場合

1. イメージをビルドします：

docker build -t mdslides .

2. コンテナを実行します：

docker run --rm -it -v $(pwd):/app mdslides

📚 ドキュメント

サーバー構成例

# config.py
class MCPConfig:
    def __init__(self):
        self.server_port = 8000  # サーバーポートを設定
        self.output_dir = "mkslides_output"  # 出力ディレクトリを設定
        self.default_theme = "white"  # デフォルトテーマを設定

💻 使用例

Claude/VSCodeでの使用例

<!-- use_mcp_tool.xml -->
<use_mcp_tool>
    <tool_name>generate_slides</tool_name>
    <parameters>
        <markdown_content>## タイトル\n- 項目1\n- 項目2</markdown_content>
        <slides_theme>black</slides_theme>
        <revealjs_options>
            <transition>slide</transition>
        </revealjs_options>
    </parameters>
</use_mcp_tool>

これにより、「黒」のテーマと「スライド」のトランジションエフェクトを使用してプレゼンテーションが生成され、デフォルトのディレクトリ./mkslides_outputに出力されます。

🔧 技術詳細

コントリビューションガイド

コントリビューションを歓迎します！通常のGitHubフローに従って、リポジトリをフォークし、機能ブランチを作成し、プルリクエストを送信してください。

テスト方法

現在、テスト用のプレースホルダーファイル（tests/test_server.py）があります。pytestなどのテストランナーを使用してテストを実行します：

pytest

tests/test_server.pyに実際のテストケースを追加することを忘れないでください。

ソースコードからのビルド

pipを使用したインストール手順に従って開発環境を設定します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細についてはLICENSEファイルを参照してください。（注意：現在のリポジトリにはLICENSEファイルがありません。作成することをお勧めします。）

謝辞

• mkslides：コアのスライド生成機能に感謝します。
• モデルコンテキストプロトコル：サーバー統合のサポートに感謝します。