Servidor MCP de Office PowerPoint
Un servidor MCP (Protocolo de Contexto de Modelo) para la manipulación de PowerPoint mediante python-pptx. Este servidor proporciona herramientas para crear, editar y manipular presentaciones de PowerPoint mediante el protocolo MCP.
Ejemplo
Pormpt
Producción
GIF de demostración -> (./public/demo.mp4)
Características
- Viaje de ida y vuelta a cualquier presentación Open XML (archivo .pptx) incluidos todos sus elementos
- Agregar diapositivas
- Rellene los marcadores de posición de texto, por ejemplo, para crear una diapositiva con viñetas
- Agregar imagen a la diapositiva en una posición y tamaño arbitrarios
- Agregar cuadro de texto a una diapositiva; manipular el tamaño de fuente del texto y negrita
- Agregar tabla a una diapositiva
- Agregar formas automáticas (por ejemplo, polígonos, formas de diagrama de flujo, etc.) a una diapositiva
- Agregar y manipular gráficos de columnas, barras, líneas y circulares
- Acceder y cambiar las propiedades principales del documento, como el título y el asunto
Instalación
Para instalar PowerPoint Manipulation Server para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install @GongRzhe/Office-PowerPoint-MCP-Server --client claude
Prerrequisitos
- Python 3.10 o superior
- gestor de paquetes pip
Opciones de instalación
Opción 1: Usar el script de configuración (recomendado)
La forma más sencilla de configurar PowerPoint MCP Server es utilizar el script de instalación proporcionado, que automatiza el proceso de instalación:
Este script hará lo siguiente:
- Consultar prerrequisitos
- Ofrecer opciones de instalación:
- Instalar desde PyPI (recomendado para la mayoría de los usuarios)
- Establecer un entorno de desarrollo local
- Instalar las dependencias necesarias
- Generar el archivo de configuración MCP apropiado
- Proporcionar instrucciones para la integración con Claude Desktop
El script ofrece diferentes rutas según su entorno:
- Si tiene instalado
uvx , se configurará usando UVX (recomendado) - Si el servidor ya está instalado, proporciona opciones de configuración
- Si el servidor no está instalado, ofrece métodos de instalación.
Opción 2: Instalación manual
- Clonar el repositorio:
git clone https://github.com/GongRzhe/Office-PowerPoint-MCP-Server.git
cd Office-PowerPoint-MCP-Server
- Instalar dependencias:
pip install -r requirements.txt
- Hacer que el servidor sea ejecutable:
chmod +x ppt_mcp_server.py
Uso
Iniciando el servidor
Ejecutar el servidor:
Configuración de MCP
Opción 1: Servidor Python local
Agregue el servidor a su archivo de configuración de MCP:
{
"mcpServers": {
"ppt": {
"command": "python",
"args": ["/path/to/ppt_mcp_server.py"],
"env": {}
}
}
}
Opción 2: Usar UVX (no requiere instalación local)
Si tiene uvx instalado, puede ejecutar el servidor directamente desde PyPI sin instalación local:
{
"mcpServers": {
"ppt": {
"command": "uvx",
"args": [
"--from", "office-powerpoint-mcp-server", "ppt_mcp_server"
],
"env": {}
}
}
}
Herramientas disponibles
Herramientas de presentación
- create_presentation : Crea una nueva presentación de PowerPoint
- open_presentation : abre una presentación de PowerPoint existente desde un archivo
- save_presentation : Guarda la presentación actual en un archivo
- get_presentation_info : Obtener información sobre la presentación actual
- set_core_properties : Establece las propiedades principales del documento de la presentación actual
Herramientas de diapositivas
- add_slide : Agrega una nueva diapositiva a la presentación actual
- get_slide_info : Obtener información sobre una diapositiva específica
- populate_placeholder : rellenar un marcador de posición con texto
- add_bullet_points : Agregar viñetas a un marcador de posición
Herramientas de texto
- add_textbox : Agrega un cuadro de texto a una diapositiva
Herramientas de imagen
- add_image : Agregar una imagen a una diapositiva
- add_image_from_base64 : Agrega una imagen desde una cadena codificada en base64 a una diapositiva
Herramientas de tabla
- add_table : Agregar una tabla a una diapositiva
- format_table_cell : Formatear una celda de tabla
- add_shape : Agrega una forma automática a una diapositiva
Herramientas de gráficos
- add_chart : Agregar un gráfico a una diapositiva
Ejemplos
Crear una nueva presentación
# Create a new presentation
result = use_mcp_tool(
server_name="ppt",
tool_name="create_presentation",
arguments={}
)
presentation_id = result["presentation_id"]
# Add a title slide
result = use_mcp_tool(
server_name="ppt",
tool_name="add_slide",
arguments={
"layout_index": 0, # Title slide layout
"title": "My Presentation",
"presentation_id": presentation_id
}
)
slide_index = result["slide_index"]
# Populate subtitle placeholder
result = use_mcp_tool(
server_name="ppt",
tool_name="populate_placeholder",
arguments={
"slide_index": slide_index,
"placeholder_idx": 1, # Subtitle placeholder
"text": "Created with PowerPoint MCP Server",
"presentation_id": presentation_id
}
)
# Save the presentation
result = use_mcp_tool(
server_name="ppt",
tool_name="save_presentation",
arguments={
"file_path": "my_presentation.pptx",
"presentation_id": presentation_id
}
)
Agregar un gráfico
# Add a chart slide
result = use_mcp_tool(
server_name="ppt",
tool_name="add_slide",
arguments={
"layout_index": 1, # Content slide layout
"title": "Sales Data",
"presentation_id": presentation_id
}
)
slide_index = result["slide_index"]
# Add a column chart
result = use_mcp_tool(
server_name="ppt",
tool_name="add_chart",
arguments={
"slide_index": slide_index,
"chart_type": "column",
"left": 1.0,
"top": 2.0,
"width": 8.0,
"height": 4.5,
"categories": ["Q1", "Q2", "Q3", "Q4"],
"series_names": ["2023", "2024"],
"series_values": [
[100, 120, 140, 160],
[110, 130, 150, 170]
],
"has_legend": True,
"legend_position": "bottom",
"has_data_labels": True,
"title": "Quarterly Sales",
"presentation_id": presentation_id
}
)
Licencia
Instituto Tecnológico de Massachusetts (MIT)