Office-PowerPoint-MCP-Server 项目启动与配置教程

1. 项目目录结构及介绍

Office-PowerPoint-MCP-Server 项目是一个基于 Python 的 MCP（Model Context Protocol）服务器，用于通过 MCP 协议操作 PowerPoint 演示文稿。以下是项目的目录结构及各部分功能的简要介绍：

Office-PowerPoint-MCP-Server/
│
├── .gitignore                 # 忽略文件列表
├── Dockerfile                 # Docker 容器配置文件
├── LICENSE                    # 项目许可证文件
├── README.md                  # 项目说明文件
├── __init__.py                # Python 初始化文件
├── mcp-config.json            # MCP 配置文件示例
├── mcp_config_sample.json     # MCP 配置文件示例
├── ppt_mcp_server.py          # PowerPoint MCP 服务器主文件
├── ppt_utils.py               # PowerPoint 工具函数文件
├── pyproject.toml             # Python 项目配置文件
├── requirements.txt           # 项目依赖文件
├── setup_mcp.py               # 设置 MCP 项目的脚本
└── smithery.yaml              # Smithery 配置文件

• .gitignore: 指定 Git 忽略的文件和目录。
• Dockerfile: 用于创建 Docker 容器的配置文件。
• LICENSE: 项目的 MIT 许可证文件。
• README.md: 项目说明文件，包含项目介绍、安装、配置和使用信息。
• __init__.py: Python 包的初始化文件，使目录作为 Python 模块使用。
• mcp-config.json 和 mcp_config_sample.json: MCP 配置文件示例，用于指导用户如何设置 MCP 服务器。
• ppt_mcp_server.py: PowerPoint MCP 服务器的核心文件，用于启动服务器和处理请求。
• ppt_utils.py: 包含操作 PowerPoint 演示文稿的实用函数。
• pyproject.toml: Python 项目配置文件，包含项目元数据和依赖。
• requirements.txt: 项目依赖文件，列出项目所需的 Python 包。
• setup_mcp.py: 设置 MCP 项目的脚本，用于自动化安装和配置过程。
• smithery.yaml: Smithery 配置文件，用于 Smithery 集成。

2. 项目的启动文件介绍

项目的启动文件为 ppt_mcp_server.py。以下是启动文件的主要内容：

# 导入必要的模块和包
from ppt_mcp_server import start_server

# 启动 MCP 服务器
if __name__ == "__main__":
    start_server()

该文件负责启动 PowerPoint MCP 服务器。在执行 python ppt_mcp_server.py 命令时，服务器会开始监听指定端口，等待客户端的连接和请求。

3. 项目的配置文件介绍

项目的配置文件为 mcp-config.json。以下是配置文件的一个示例：

{
    "mcpServers": {
        "ppt": {
            "command": "python",
            "args": ["/path/to/ppt_mcp_server.py"],
            "env": {}
        }
    }
}

该配置文件指定了 MCP 服务器的一些基本信息，例如启动命令、命令参数和运行环境。用户需要根据实际路径修改 "args" 中的路径，以确保服务器能够正确启动。

在完成配置文件的修改后，用户可以根据配置文件中的设置来启动和运行 PowerPoint MCP 服务器。