iflow-mcp_slidev-mcp 0.1.1__py3-none-any.whl

iflow_mcp_slidev_mcp-0.1.1.dist-info/METADATA

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_slidev-mcp
+Version: 0.1.1
+Summary: A smart slide generator based on Slidev and LLM
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: crawl4ai>=0.7.0
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: mcp[cli]>=1.9.4
+Requires-Dist: rich>=14.1.0
+Requires-Dist: usermcp>=0.1.2
+Dynamic: license-file
+
+<div align="center">
+  <h1>
+    <img src="https://api.iconify.design/logos:slidev.svg" width="40" height="40" alt="Slidev"/>
+    slidev-mcp 
+    <img src="https://api.iconify.design/logos:openai-icon.svg" width="40" height="40" alt="AI"/>
+  </h1>
+  <p>AI-powered Professional Slide Creation Made Easy!</p>
+  
+  <p>
+    <strong>English</strong> | <a href="README.zh.md">中文</a> | <a href="https://github.com/LSTM-Kirigaya/slidev-ai">Slidev-AI</a>
+  </p>
+  
+  <div>
+    <img src="https://img.shields.io/badge/Slidev-@latest-blue?logo=slidev" alt="Slidev"/>
+    <img src="https://img.shields.io/badge/AI-Large%20Language%20Model-orange?logo=openai" alt="AI"/>
+    <img src="https://img.shields.io/badge/TypeScript-4.9.5-blue?logo=typescript" alt="TypeScript"/>
+    <img src="https://img.shields.io/badge/Vue-3.3-green?logo=vue.js" alt="Vue 3"/>
+  </div>
+</div>
+
+## ✨ Introduction
+
+slidev-mcp is an intelligent slide generation tool based on [Slidev](https://github.com/slidevjs/slidev) that integrates large language model technology, allowing users to automatically generate professional online PPT presentations with simple descriptions.
+
+<img src="https://api.iconify.design/mdi:robot-happy-outline.svg" width="20" height="20" alt="AI"/> **Key Features**:
+- Dramatically lowers the barrier to using Slidev
+- Natural language interactive slide creation
+- Automated generation of professional presentations
+
+We have also open-sourced the AI PPT integrated website project based on slidev-mcp [Slidev-AI](https://github.com/LSTM-Kirigaya/slidev-ai), and you can see the effect in the following video 👇
+
+<a href="https://www.bilibili.com/video/BV1SMhBzJEUL/?spm_id_from=333.1387.homepage.video_card.click&vd_source=3f248073d6ebdb61308992901b606f24" target="_blank"><img src="https://pica.zhimg.com/80/v2-3674ccdc2ceef8255724dbf078cf6ee7_1440w.png" /></a>
+
+## 🚀 Quick Start
+
+For detailed setup and usage instructions, please see [Quick Start Guide](docs/quickstart.md).
+
+### Environment Variable
+
+You can customize the root directory where generated Slidev projects are stored by setting the environment variable `SLIDEV_MCP_ROOT` (MUST be an absolute path). If not set (or set as a non-absolute path), the default relative directory `.slidev-mcp` (under current working directory) is used.
+
+Example (Windows cmd, PowerShell similar):
+
+Projects will then be created under that absolute path instead of `.slidev-mcp/`.
+
+```bash
+# powershell
+set SLIDEV_MCP_ROOT=my-slides
+
+# bash or zsh
+export SLIDEV_MCP_ROOT=my-slides
+
+# then run the script
+uv run servers/themes/academic/server.py
+```
+
+Projects will then be created under `my-slides/` instead of `.slidev-mcp/`.
+
+## 🔧 Available Tools
+
+The MCP server provides the following tools for slide creation and management:
+
+### Environment & Project Management
+
+| Tool | Input Parameters | Output | Purpose |
+|------|------------------|--------|---------|
+| `check_environment` | None | Environment status and version info | Verify dependencies are installed |
+| `create_slidev` | `path` (str), `title` (str), `author` (str) | Project creation status and path | Initialize new Slidev project |
+| `load_slidev` | `path` (str) | Project content and slide data | Load existing presentation |
+
+### Slide Content Management
+
+| Tool | Input Parameters | Output | Purpose |
+|------|------------------|--------|---------|
+| `make_cover` | `title` (str), `subtitle` (str, opt), `author` (str, opt), `background` (str, opt), `python_string_template` (str, opt) | Cover slide creation status | Create/update cover page |
+| `add_page` | `content` (str), `layout` (str, opt) | New slide index | Add new slide to presentation |
+| `set_page` | `index` (int), `content` (str), `layout` (str, opt) | Update status | Modify existing slide content |
+| `get_page` | `index` (int) | Slide content in markdown | Retrieve specific slide content |
+
+### Utility Tools
+
+| Tool | Input Parameters | Output | Purpose |
+|------|------------------|--------|---------|
+| `websearch` | `url` (str) | Extracted markdown text | Gather web content for slides |
+
+
+> **Note**: `opt` = optional parameter
+
+## 📄 License
+
+MIT License © 2023 [LSTM-Kirigaya](https://github.com/LSTM-Kirigaya)

iflow_mcp_slidev_mcp-0.1.1.dist-info/RECORD

@@ -0,0 +1,24 @@
+iflow_mcp_slidev_mcp-0.1.1.dist-info/licenses/LICENSE,sha256=r1StZ__YFZaFhNjtteKSNGBvGSsM27wZu0d-N-N3rXU,1072
+servers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+servers/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+servers/core/base.py,sha256=quuI7-0LXsHhEcmVeK7LOSDsiIjHyRXQqF6u9qgveJo,5518
+servers/core/base_server.py,sha256=7rvIBHFuUns4E5snLA8HYf8toCQyBvQnz12AZg4KmUA,7317
+servers/core/common.py,sha256=wOsN94cUJtSdGICmpn9LYRRS8RDNkveXpVb-IcQZ8YI,4086
+servers/core/prompt_manager.py,sha256=lv6AKHC7kgleYO1x9DP8oZF7OZii35HuQMoN-xcKbpw,640
+servers/core/state_manager.py,sha256=o6dvZbCmX_frj6x4IepoWS6y9EHx3BfVhgqzhn4zZEQ,3309
+servers/core/template_manager.py,sha256=tYircqy4stEqXUEqqrWk7it6jsQCnWXi5iiAXKnJ1fk,652
+servers/models/__init__.py,sha256=gh_OAVgHVr4J6kF2wRqZuqz325jQ6l5iLGhvKTvBp3c,21
+servers/models/prompt.py,sha256=21ouaoPc9SUmk70as7ricxjKfbgrzwjAekOgydexgXU,259
+servers/models/slidev.py,sha256=D7tAacIKxufPzJ8s6_m28F6ew_1TBzj6pMfnS5NOhIQ,938
+servers/models/template.py,sha256=Zbi6nJnX0yyqcOdLzw8e9yQCizSpPUAAptHt5DG3JS8,125
+servers/themes/academic/server.py,sha256=54qvuqySKQzG6nNMoKeAOyZSBsq1xt4ZYpTWe8Y0j0E,555
+servers/themes/default/server.py,sha256=_fSJrftVuKf9HxvK-8sQnegySWKTz_jmz1yMkPAFrpE,500
+servers/themes/frankfurt/server.py,sha256=_fSJrftVuKf9HxvK-8sQnegySWKTz_jmz1yMkPAFrpE,500
+servers/themes/miracle/server.py,sha256=_fSJrftVuKf9HxvK-8sQnegySWKTz_jmz1yMkPAFrpE,500
+servers/themes/penguin/server.py,sha256=_fSJrftVuKf9HxvK-8sQnegySWKTz_jmz1yMkPAFrpE,500
+servers/themes/vuetiful/server.py,sha256=_fSJrftVuKf9HxvK-8sQnegySWKTz_jmz1yMkPAFrpE,500
+iflow_mcp_slidev_mcp-0.1.1.dist-info/METADATA,sha256=J31Jt5vaunUw1OP07vF4DcLe_NECaqqweA7-2xh2-eA,4616
+iflow_mcp_slidev_mcp-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+iflow_mcp_slidev_mcp-0.1.1.dist-info/entry_points.txt,sha256=1sNmazyGHp3hYreH_QRv5ETVAAWnfj5tbE-VjNhQzMM,67
+iflow_mcp_slidev_mcp-0.1.1.dist-info/top_level.txt,sha256=e5H7rQydEqFwuiinKPgmRo5GjCuR1U_rzYIS817rETg,8
+iflow_mcp_slidev_mcp-0.1.1.dist-info/RECORD,,

iflow_mcp_slidev_mcp-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

iflow_mcp_slidev_mcp-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+slidev-mcp = servers.themes.academic.server:main

iflow_mcp_slidev_mcp-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kirigaya Kazuto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

iflow_mcp_slidev_mcp-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+servers

servers/core/base.py

@@ -0,0 +1,145 @@
+from pathlib import Path
+import os
+
+from servers.models.slidev import SlidevResult, SaveOutlineParam, SlidevCreateParam, SlidevMakeCoverParam, SlidevAddPageParam, SlidevSetPageParam, SlidevGetPageParam, SlidevLoadParam
+from servers.models.template import TemplateName
+from servers.core.state_manager import SlidevStateManager
+from servers.core.template_manager import TemplateManager
+
+class SlidevBase:
+    def __init__(
+            self,
+            theme: str,
+            state_manager: SlidevStateManager,
+            template_manager: TemplateManager,
+        ):
+        """
+        Base class for slidev MCP tools
+        - state_manager: SlidevStateManager 实例
+        - theme: 默认主题
+        """
+        self.state_manager = state_manager
+        self.template_manager = template_manager
+        self.theme = theme
+
+    def create(self, param: SlidevCreateParam) -> SlidevResult:
+        """创建 slidev 项目"""
+        name = param.name
+        home = self.state_manager.get_project_home(name)
+
+        os.makedirs(home, exist_ok=True)
+        slides_path = os.path.join(home, 'slides.md')
+
+        if os.path.exists(slides_path):
+            return self.load(SlidevLoadParam(name=name))
+        else:
+            template = self.template_manager.render(
+                TemplateName.cover.value,
+                {
+                    "title": name
+                }
+            )
+
+            with open(slides_path, 'w', encoding="utf-8") as f:
+                f.write(template)
+            
+            if not self.state_manager.load_slidev_content(name):
+                return SlidevResult(success=False, message="项目创建成功但加载失败", data=name)
+
+        return SlidevResult(success=True, message=f"成功创建并加载项目 {name}", data=name)
+
+    def load(self, param: SlidevLoadParam) -> SlidevResult:
+        """加载已有项目"""
+        
+        name = param.name
+        slides_path = Path(self.state_manager.get_project_home(name)) / "slides.md"
+
+        if self.state_manager.load_slidev_content(name):
+            return SlidevResult(
+                success=True,
+                message=f"项目加载成功: {slides_path.absolute()}",
+                data=self.state_manager.get_slidev_content()
+            )
+        return SlidevResult(success=False, message=f"加载失败: {slides_path.absolute()}")
+
+    def make_cover(self, param: SlidevMakeCoverParam) -> SlidevResult:
+        """创建/更新封面"""
+        if not self.state_manager.is_project_loaded():
+            return SlidevResult(success=False, message="没有激活的项目")
+
+        template = self.template_manager.render(
+            template_name=TemplateName.cover.value,
+            context=param.model_dump()
+        )
+
+        self.state_manager.set_slidev_page(0, template)
+        self.state_manager.save_slidev_content()
+
+        return SlidevResult(success=True, message="封面已更新")
+
+    def add_page(self, param: SlidevAddPageParam) -> SlidevResult:
+        """添加页面"""
+        if not self.state_manager.is_project_loaded():
+            return SlidevResult(success=False, message="没有激活的项目")
+
+        template = self.template_manager.render(
+            TemplateName.page.value,
+            {
+                "content": param.content,
+                "layout": param.layout,
+                "parameters": param.parameters
+            }
+        )
+
+        new_index = self.state_manager.add_page_content(template)
+        self.state_manager.save_slidev_content()
+
+        return SlidevResult(success=True, message=f"新页面添加完成，添加到第 {new_index} 页")
+
+    def set_page(self, param: SlidevSetPageParam) -> SlidevResult:
+        """更新页面"""
+        if not self.state_manager.is_project_loaded():
+            return SlidevResult(success=False, message="没有激活的项目")
+
+        slides = self.state_manager.get_slidev_content()
+        index = param.index
+
+        if index < 0 or index >= len(slides):
+            return SlidevResult(success=False, message=f"无效的页码 {index}")
+
+        template = self.template_manager.render(
+            TemplateName.page.value,
+            {
+                "content": param.content,
+                "layout": param.layout,
+                "parameters": param.parameters
+            }
+        )
+
+        self.state_manager.set_slidev_page(index, template)
+        self.state_manager.save_slidev_content()
+
+        return SlidevResult(success=True, message=f"第 {index} 页更新完成")
+
+    def get_page(self, param: SlidevGetPageParam) -> SlidevResult:
+        """获取页面内容"""
+
+        index = param.index
+        if not self.state_manager.is_project_loaded():
+            return SlidevResult(success=False, message="没有激活的项目")
+
+        slides = self.state_manager.get_slidev_content()
+        if index < 0 or index >= len(slides):
+            return SlidevResult(success=False, message=f"无效的页码 {index}")
+
+        return SlidevResult(success=True, message=f"第 {index} 页内容")
+
+    def save_outline(self, param: SaveOutlineParam) -> SlidevResult:
+        """保存 outline.json"""
+        if self.state_manager.save_outline_content(param):
+            return SlidevResult(success=True, message="大纲保存成功")
+        return SlidevResult(success=False, message="保存失败，没有激活的项目")
+
+    def export_project(self, path: str):
+        """导出项目元信息"""
+        return self.state_manager.active_project

servers/core/base_server.py

@@ -0,0 +1,213 @@
+import asyncio
+
+from mcp.server.fastmcp import FastMCP
+# user profile mcp: https://github.com/LSTM-Kirigaya/usermcp
+from usermcp import register_user_profile_mcp
+from colorama import Fore, Style
+
+from servers.core.common import websearch, check_environment
+from servers.core.state_manager import SlidevStateManager
+from servers.core.prompt_manager import PromptManager
+from servers.core.template_manager import TemplateManager
+from servers.core.base import SlidevBase
+from servers.models.slidev import SlidevResult, SlidevCreateParam, SlidevMakeCoverParam, SlidevAddPageParam, SlidevSetPageParam, SlidevLoadParam, SlidevGetPageParam, SaveOutlineParam
+from servers.models.prompt import PromptName
+from servers.core.common import print_prompts, print_resource_templates, print_resources, print_tools
+
+class SlidevBaseServer:
+    def __init__(self,
+        mcp: FastMCP,
+        theme: str,
+        template_dir: str,
+        prompt_dir: str
+    ):
+        self.mcp = mcp
+        self.state_manager = SlidevStateManager(theme=theme)
+        self.template_manager = TemplateManager(template_dir)
+        self.prompt_manager = PromptManager(prompt_dir)
+
+        self.slidev = SlidevBase(theme, self.state_manager, self.template_manager)
+
+        self.install_usermcp_tools()
+        self.install_crawl4ai_tools()
+        self.install_slidev_tools()
+        self.install_slidev_prompts()
+
+        asyncio.run(show_mcp_detail(mcp))
+
+    def install_usermcp_tools(self):
+        register_user_profile_mcp(self.mcp)
+    
+    def install_crawl4ai_tools(self):
+        self.mcp.add_tool(
+            fn=websearch,
+            name='websearch',
+            description='search the given https url and get the markdown text of the website'
+        )
+    
+    def install_slidev_tools(self):
+        slidev = self.slidev
+        mcp = self.mcp
+
+        @mcp.tool()
+        def slidev_check_environment() -> SlidevResult:
+            """
+            Check if nodejs and slidev-cli is ready.
+            
+            Returns:
+                SlidevResult: Result indicating if the environment is properly set up
+            """
+            return check_environment()
+
+
+        @mcp.tool()
+        def slidev_create(param: SlidevCreateParam):
+            """
+            Create a new slidev project with the given name.
+            
+            Args:
+                name (str): The name of the slidev project to create
+                
+            Returns:
+                SlidevResult: Result indicating success or failure of the creation process
+            """
+            return slidev.create(param)
+
+        @mcp.tool()
+        def slidev_load(param: SlidevLoadParam) -> SlidevResult:
+            """
+            Load an existing slidev project.
+            
+            Args:
+                param (SlidevLoadParam): Parameter containing the name of the project to load
+                
+            Returns:
+                SlidevResult: Result containing the loaded project data or error message
+            """
+            return slidev.load(param)
+
+
+        @mcp.tool()
+        def slidev_make_cover(param: SlidevMakeCoverParam) -> SlidevResult:
+            """
+            Create or update slidev cover.
+            
+            Args:
+                param (SlidevMakeCoverParam): Parameters for creating/updating the cover
+                
+            Returns:
+                SlidevResult: Result indicating success or failure of the operation
+            """
+            return slidev.make_cover(param)
+        
+
+        @mcp.tool()
+        def slidev_add_page(param: SlidevAddPageParam) -> SlidevResult:
+            """
+            Add a new page to the slidev presentation.
+            
+            Args:
+                param (SlidevAddPageParam): Parameters for the new page including content, layout and parameters
+                
+            Returns:
+                SlidevResult: Result indicating success or failure of the operation
+            """
+            return slidev.add_page(param)
+
+
+        @mcp.tool()
+        def slidev_set_page(param: SlidevSetPageParam) -> SlidevResult:
+            """
+            Update an existing page in the slidev presentation.
+            
+            Args:
+                param (SlidevSetPageParam): Parameters for updating the page including index, content, layout and parameters
+                
+            Returns:
+                SlidevResult: Result indicating success or failure of the operation
+            """
+            return slidev.set_page(param)
+
+
+        @mcp.tool()
+        def slidev_get_page(param: SlidevGetPageParam) -> SlidevResult:
+            """
+            Get the content of a specific page in the slidev presentation.
+            
+            Args:
+                param (SlidevGetPageParam): Parameter containing the index of the page to retrieve
+                
+            Returns:
+                SlidevResult: Result containing the page content or error message
+            """
+            return slidev.get_page(param)
+        
+        @mcp.tool()
+        def slidev_export_project():
+            """export the active Slidev project"""
+            return slidev.state_manager.active_project
+        
+        @mcp.tool()
+        def slidev_save_outline(param: SaveOutlineParam) -> SlidevResult:
+            """Save outline"""
+            return slidev.save_outline(param)
+
+    def install_slidev_prompts(self):
+        mcp = self.mcp
+        prompt_manager = self.prompt_manager
+
+        @mcp.prompt()
+        def outline_generate_prompt(title: str, content: str):
+            """generate outline for slidev"""
+            return prompt_manager.render(
+                PromptName.outline_generate.value,
+                {
+                    "title": title,
+                    "content": content
+                }
+            )
+
+        @mcp.prompt()
+        def slidev_generate_prompt():
+            """generate slidev"""
+            return prompt_manager.render(
+                PromptName.slidev_generate.value,
+                {}
+            )
+
+        @mcp.prompt()
+        def slidev_generate_with_specific_outlines_prompt(title: str, content: str, outlines: str, path: str):
+            """generate slidev with specific outlines"""
+            return prompt_manager.render(
+                PromptName.slidev_generate_with_specific_outlines.value,
+                {
+                    "title": title,
+                    "content": content,
+                    "outlines": outlines,
+                    "path": path
+                }
+            )
+        
+        @mcp.prompt()
+        def slidev_user_info(username: str, email: str, website: str):
+            return prompt_manager.render(
+                PromptName.user_info.value,
+                {
+                    "username": username,
+                    "email": email,
+                    "website": website
+                }
+            )
+        
+
+async def show_mcp_detail(mcp: FastMCP):
+    tools = await mcp.list_tools()
+    prompts = await mcp.list_prompts()
+    resources = await mcp.list_resources()
+    templates = await mcp.list_resource_templates()
+    
+    print(Fore.YELLOW + Style.BRIGHT + f"\n🚀 MCP Server {mcp.name} Registry")
+    print_tools(tools)
+    print_prompts(prompts)
+    print_resources(resources)
+    print_resource_templates(templates)

servers/core/common.py

@@ -0,0 +1,128 @@
+import shutil
+import subprocess
+from typing import Optional, Union, List, Dict
+
+from crawl4ai import AsyncWebCrawler
+from colorama import Fore, Style
+
+from servers.models.slidev import SlidevResult
+
+def parse_markdown_slides(content: str) -> list:
+    """
+    解析markdown内容，按YAML front matter切分幻灯片
+    """
+    slides = []
+    current_slide = []
+    in_yaml = False
+    
+    for line in content.splitlines():
+        if line.strip() == '---' and not in_yaml:
+            # 开始YAML front matter
+            if not current_slide:
+                in_yaml = True
+                current_slide.append(line)
+            else:
+                # 遇到新的幻灯片分隔符
+                slides.append('\n'.join(current_slide))
+                current_slide = [line]
+                in_yaml = True
+        elif line.strip() == '---' and in_yaml:
+            # 结束YAML front matter
+            current_slide.append(line)
+            in_yaml = False
+        else:
+            current_slide.append(line)
+    
+    # 添加最后一个幻灯片
+    if current_slide:
+        slides.append('\n'.join(current_slide))
+    
+    return slides
+
+def transform_parameters_to_frontmatter(parameters: dict):
+    frontmatter = ""
+    for key in parameters.keys():
+        value = parameters.get(key, "")
+        frontmatter += f"{key}: {value}\n"
+    return frontmatter.strip()
+
+def check_nodejs_installed() -> bool:
+    return shutil.which("node") is not None
+
+def run_command(command: Union[str, List[str]]) -> SlidevResult:
+    try:
+        result = subprocess.run(
+            command,
+            cwd='./',
+            capture_output=True,
+            text=True,
+            shell=isinstance(command, str),
+            timeout=10,
+            stdin=subprocess.DEVNULL
+        )
+        if result.returncode == 0:
+            return SlidevResult(success=True, message="Command executed successfully", data=result.stdout)
+        else:
+            return SlidevResult(success=False, message=f"Command failed: {result.stderr}")
+    except Exception as e:
+        return SlidevResult(success=False, message=f"Error executing command: {str(e)}")
+
+
+
+async def websearch(url: str) -> SlidevResult:
+    async with AsyncWebCrawler() as crawler:
+        result = await crawler.arun(url)
+        return SlidevResult(success=True, message="success", data=result.markdown)
+
+def check_environment() -> SlidevResult:
+    if not check_nodejs_installed():
+        return SlidevResult(success=False, message="Node.js is not installed. Please install Node.js first.")
+    
+    result = run_command("slidev --version")
+    if not result.success:
+        return run_command("npm install -g @slidev/cli")
+    return SlidevResult(success=True, message="环境就绪，slidev 可以使用", data=result.data)
+
+
+def print_tools(tools):
+    if not tools:
+        print(Fore.YELLOW + "No tools registered.")
+        return
+    print(Fore.CYAN + "\nRegistered Tools:")
+    for tool in tools:
+        print(
+            f"  {Fore.GREEN}{tool.name:<30}"
+            f"{Fore.MAGENTA}{tool.description.strip().split('\n')[0] or ''}"
+        )
+
+
+def print_prompts(prompts):
+    if not prompts:
+        print(Fore.YELLOW + "No prompts registered.")
+        return
+    print(Fore.CYAN + "\nRegistered Prompts:")
+    for prompt in prompts:
+        args = ", ".join(arg.name for arg in prompt.arguments) if prompt.arguments else "-"
+        print(
+            f"  {Fore.GREEN}{prompt.name:<40}"
+            f"{Fore.BLUE}args=[{args}]  "
+            f"{Fore.MAGENTA}{prompt.description or ''}"
+        )
+
+
+def print_resources(resources):
+    if not resources:
+        print(Fore.YELLOW + "No resources registered.")
+        return
+    print(Fore.CYAN + "\nRegistered Resources:")
+    for res in resources:
+        print(f"  {Fore.GREEN}{res}")
+
+
+def print_resource_templates(templates):
+    if not templates:
+        print(Fore.YELLOW + "No resource templates registered.")
+        return
+    print(Fore.CYAN + "\nRegistered Resource Templates:")
+    for tmpl in templates:
+        print(f"  {Fore.GREEN}{tmpl}")

servers/core/prompt_manager.py

@@ -0,0 +1,19 @@
+from jinja2 import Environment, FileSystemLoader, select_autoescape
+from pathlib import Path
+from typing import Dict, Any
+
+from servers.models.prompt import PromptName
+
+class PromptManager:
+    def __init__(self, prompt_dir: str = None):
+        if prompt_dir is None:
+            prompt_dir = str(Path(__file__).parent / "prompts")
+
+        self.env = Environment(
+            loader=FileSystemLoader(prompt_dir),
+            autoescape=False
+        )
+        
+    def render(self, template_name: PromptName, context: Dict[str, Any]) -> str:
+        template = self.env.get_template(template_name)
+        return template.render(context)

servers/core/state_manager.py

@@ -0,0 +1,97 @@
+import os
+from pathlib import Path
+from typing import Optional, Dict, List
+import warnings
+
+from servers.models.slidev import SaveOutlineParam
+from servers.core.common import parse_markdown_slides
+
+class SlidevStateManager:
+    def __init__(self,
+            root_env_var: str = "SLIDEV_MCP_ROOT",
+            default_root: str = ".slidev-mcp",
+            theme: str = "academic"
+        ):
+
+        _env_root = os.environ.get(root_env_var)
+        if _env_root and os.path.isabs(_env_root):
+            self.root_dir = _env_root
+        else:
+            self.root_dir = default_root
+        os.makedirs(self.root_dir, exist_ok=True)
+
+        self.active_project: Optional[Dict] = None
+        self.slidev_content: List[str] = []
+        self.max_page_index = 999
+        self.theme = theme
+
+    def get_project_home(self, name: str) -> str:
+        return os.path.join(self.root_dir, name)
+
+    def set_active_project(self, name: str, slides_path: str):
+        self.active_project = {
+            "name": name,
+            "home": self.get_project_home(name),
+            "slides_path": slides_path
+        }
+
+    def clear_active_project(self):
+        self.active_project = None
+        self.slidev_content = []
+
+    def set_slidev_content(self, slides: List[str]):
+        self.slidev_content = slides
+
+    def get_slidev_content(self) -> List[str]:
+        return self.slidev_content
+    
+    def set_slidev_page(self, index: int, content: str):
+        if index < 0 or index >= self.max_page_index:
+            warnings.warn(f"Invalid page index: {index}")
+            return False
+
+        if index >= len(self.slidev_content):
+            self.slidev_content.append(content)
+        else:
+            self.slidev_content[index] = content
+
+    def add_page_content(self, content: str):
+        self.slidev_content.append(content)
+        return len(self.slidev_content) - 1
+
+    def is_project_loaded(self) -> bool:
+        return self.active_project is not None
+
+    def load_slidev_content(self, name: str) -> bool:
+        """加载指定项目的 slides.md，并设置为 active project"""
+        home = self.get_project_home(name)
+        slides_path = Path(home) / "slides.md"
+
+        if not slides_path.exists():
+            return False
+
+        with open(slides_path.absolute(), "r", encoding="utf-8") as f:
+            content = f.read()
+
+        # 更新状态
+        self.set_active_project(name, str(slides_path))
+        slides = parse_markdown_slides(content)
+        self.set_slidev_content([s.strip() for s in slides if s.strip()])
+        return True
+
+    def save_slidev_content(self) -> bool:
+        """保存当前项目的 slides 内容到 slides.md"""
+        if not self.is_project_loaded():
+            return False
+        with open(self.active_project["slides_path"], "w", encoding="utf-8") as f:
+            f.write("\n\n".join(self.get_slidev_content()))
+        return True
+
+    def save_outline_content(self, outline: "SaveOutlineParam") -> bool:
+        """保存 outline.json"""
+        if not self.is_project_loaded():
+            return False
+        outline_path = os.path.join(self.active_project["home"], "outline.json")
+        with open(outline_path, "w", encoding="utf-8") as f:
+            f.write(outline.model_dump_json(indent=2))
+        return True

servers/core/template_manager.py

@@ -0,0 +1,19 @@
+from jinja2 import Environment, FileSystemLoader, select_autoescape
+from pathlib import Path
+from typing import Dict, Any
+
+from servers.models.template import TemplateName
+
+class TemplateManager:
+    def __init__(self, template_dir: str = None):
+        if template_dir is None:
+            template_dir = str(Path(__file__).parent / "templates")
+
+        self.env = Environment(
+            loader=FileSystemLoader(template_dir),
+            autoescape=False
+        )
+
+    def render(self, template_name: TemplateName, context: Dict[str, Any]) -> str:
+        template = self.env.get_template(template_name)
+        return template.render(**context)

servers/models/__init__.py

@@ -0,0 +1 @@
+from .slidev import *

servers/models/prompt.py

@@ -0,0 +1,7 @@
+from enum import Enum
+
+class PromptName(str, Enum):
+    outline_generate = 'outline_generate.j2'
+    slidev_generate_with_specific_outlines = 'slidev_generate_with_specific_outlines.j2'
+    slidev_generate = 'slidev_generate.j2'
+    user_info = 'user_info.j2'

servers/models/slidev.py

@@ -0,0 +1,50 @@
+from typing import Optional, Union, List, Dict
+from pydantic import BaseModel
+
+
+class SlidevResult(BaseModel):
+    success: bool
+    message: str
+    data: Optional[Union[str, int, List[str]]] = None
+
+
+class OutlineItem(BaseModel):
+    group: str
+    content: str
+
+
+class SaveOutlineParam(BaseModel):
+    outlines: List[OutlineItem]
+
+
+class SlidevCreateParam(BaseModel):
+    name: str
+
+
+class SlidevLoadParam(BaseModel):
+    name: str
+
+
+class SlidevMakeCoverParam(BaseModel):
+    title: str
+    subtitle: Optional[str] = ""
+    author: Optional[str] = ""
+    authorUrl: Optional[str] = ""
+    backgroundUrl: Optional[str] = ""
+
+
+class SlidevAddPageParam(BaseModel):
+    content: str
+    layout: str = "default"
+    parameters: Optional[Dict] = {}
+
+
+class SlidevSetPageParam(BaseModel):
+    index: int
+    content: str
+    layout: Optional[str] = ""
+    parameters: Optional[Dict] = {}
+
+
+class SlidevGetPageParam(BaseModel):
+    index: int

servers/models/template.py

@@ -0,0 +1,6 @@
+from enum import Enum
+
+class TemplateName(str, Enum):
+    cover = 'cover.md.j2'
+    page = 'page.md.j2'
+    end = 'end.md.j2'

servers/themes/academic/server.py

@@ -0,0 +1,25 @@
+import sys
+from pathlib import Path
+
+project_root = Path(__file__).parent.parent.parent.parent
+current_path = Path(__file__).parent
+theme = current_path.name
+
+sys.path.insert(0, str(project_root))
+
+from mcp.server.fastmcp import FastMCP
+from servers.core.base_server import SlidevBaseServer
+
+mcp = FastMCP(f'slidev-mcp-{theme}')
+server = SlidevBaseServer(
+    mcp=mcp,
+    theme=theme,
+    prompt_dir=current_path / 'prompts',
+    template_dir=current_path / 'templates'
+)
+
+def main():
+    mcp.run(transport='stdio')
+
+if __name__ == "__main__":
+    main()

servers/themes/default/server.py

@@ -0,0 +1,21 @@
+import sys
+from pathlib import Path
+
+project_root = Path(__file__).parent.parent.parent.parent
+current_path = Path(__file__).parent
+theme = current_path.name
+
+sys.path.insert(0, str(project_root))
+
+from mcp.server.fastmcp import FastMCP
+from servers.core.base_server import SlidevBaseServer
+
+mcp = FastMCP(f'slidev-mcp-{theme}')
+server = SlidevBaseServer(
+    mcp=mcp,
+    theme=theme,
+    prompt_dir=current_path / 'prompts',
+    template_dir=current_path / 'templates'
+)
+
+mcp.run(transport='stdio')

servers/themes/frankfurt/server.py

@@ -0,0 +1,21 @@
+import sys
+from pathlib import Path
+
+project_root = Path(__file__).parent.parent.parent.parent
+current_path = Path(__file__).parent
+theme = current_path.name
+
+sys.path.insert(0, str(project_root))
+
+from mcp.server.fastmcp import FastMCP
+from servers.core.base_server import SlidevBaseServer
+
+mcp = FastMCP(f'slidev-mcp-{theme}')
+server = SlidevBaseServer(
+    mcp=mcp,
+    theme=theme,
+    prompt_dir=current_path / 'prompts',
+    template_dir=current_path / 'templates'
+)
+
+mcp.run(transport='stdio')

servers/themes/miracle/server.py

@@ -0,0 +1,21 @@
+import sys
+from pathlib import Path
+
+project_root = Path(__file__).parent.parent.parent.parent
+current_path = Path(__file__).parent
+theme = current_path.name
+
+sys.path.insert(0, str(project_root))
+
+from mcp.server.fastmcp import FastMCP
+from servers.core.base_server import SlidevBaseServer
+
+mcp = FastMCP(f'slidev-mcp-{theme}')
+server = SlidevBaseServer(
+    mcp=mcp,
+    theme=theme,
+    prompt_dir=current_path / 'prompts',
+    template_dir=current_path / 'templates'
+)
+
+mcp.run(transport='stdio')

servers/themes/penguin/server.py

@@ -0,0 +1,21 @@
+import sys
+from pathlib import Path
+
+project_root = Path(__file__).parent.parent.parent.parent
+current_path = Path(__file__).parent
+theme = current_path.name
+
+sys.path.insert(0, str(project_root))
+
+from mcp.server.fastmcp import FastMCP
+from servers.core.base_server import SlidevBaseServer
+
+mcp = FastMCP(f'slidev-mcp-{theme}')
+server = SlidevBaseServer(
+    mcp=mcp,
+    theme=theme,
+    prompt_dir=current_path / 'prompts',
+    template_dir=current_path / 'templates'
+)
+
+mcp.run(transport='stdio')

servers/themes/vuetiful/server.py

@@ -0,0 +1,21 @@
+import sys
+from pathlib import Path
+
+project_root = Path(__file__).parent.parent.parent.parent
+current_path = Path(__file__).parent
+theme = current_path.name
+
+sys.path.insert(0, str(project_root))
+
+from mcp.server.fastmcp import FastMCP
+from servers.core.base_server import SlidevBaseServer
+
+mcp = FastMCP(f'slidev-mcp-{theme}')
+server = SlidevBaseServer(
+    mcp=mcp,
+    theme=theme,
+    prompt_dir=current_path / 'prompts',
+    template_dir=current_path / 'templates'
+)
+
+mcp.run(transport='stdio')