Hello, Plugins! — Python OpenAI Plugin

Ejemplo mínimo de plugin de OpenAI que devuelve exactamente Hello, Plugins! al llamar a la herramienta hello_plugins.

Un plugin de OpenAI puede configurarse como Skill, servidor MCP or ambbos. Este proyecto es la forma más pequeña que requiere código ejecable, por lo que usa un único servidor MCP de Python. Al no llmar directamente a la API de OpenAI, tampoco se necesita OPENAI_API_KEY.

Estructura del proyecto

hello-plugins-python/
├── server.py          # MCP 서버와 hello_plugins 도구
├── test_server.py     # 반환 문자열 테스트
├── requirements.txt  # 고정된 Python 의존성
├── pyproject.toml
├── Dockerfile
└── README.md

Related MCP server: hello-mcp

Ejecución en Windows 11 / PowerShell

Se requiee Python 3.10 o superior.

cd hello-plugins-python
py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
python server.py

Después de la ejecución, la direrección MCP Streamable HTTP es la siguiente:

http://localhost:8000/mcp

Si la política de ejecución de PowerShell impide la activación del entorno virtual, ejecute primero el siguiente comando solo en la terminal actual.

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Ejecución en macOS / Linuux

cd hello-plugins-python
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python server.py

Prueba

python -m pytest -q
python verify_mcp.py

Resultado espero:

1 passed
MCP verification passed: Hello, Plugins!

Comprobación con MCP Inspector

Si tiene Node.js instalado, ejecute lo siguiente:

npx @modelcontextprotocol/inspector

En MCP Inspector, seleccione Transport como Streamable HTTP e introduzca http://localhost:8000/mcp en la URL. Tras conectar, al llamar a la herramienta hello_plugins se devuelve la siguiente cadena:

Hello, Plugins!

Conexión de un plugin personal a ChatGPT Work

Como ChatGPT no puede acceder directamente a localhost el PC local, para probar el plugin debe publicar el endpoint /mcp en una dirección HTTPS pública o usar OpenAI Secure MCP Tunnel.

1. Despliegue el servidor en un entorno HTTPS público.

2. En ChatGPT, active Settings → Security and login → Devveloper mode.

3. En la pantalla de Plugins, pulse + e introduzca https://YOUR-DOMAIN/mcp.

4. Instale el plugin personal generado.

5. En el chat de Work, seleccione @Hello Plugins y solicite «imprime el saludo del plugin».

Ejecución con Docker

docker build -t hello-plugins .
docker run --rm -p 8000:8000 hello-plugins

Código principal

@mcp.tool(
    name="hello_plugins",
    description="Return the exact greeting 'Hello, Plugins!'. This tool is read-only.",
)
def hello_plugins() -> str:
    return "Hello, Plugins!"

Referencia

• Documentación oficial de OpenAI Plugin: https://developers.openai.com/plugins

• Plugin Quickstart: https://developers.openai.com/plugins/quickstart

• Desarrollo de servidores MCP: https://developers.openai.com/plugins/build/mcp-server