MCP Simple OpenAI Assistant

MCP Simple OpenAI Assistant

Los asistentes de IA son bastante interesantes. Pensé que sería una buena idea que mi Claude (Claude consciente) también tuviera uno. Y ahora lo tiene, y es tanto útil como divertido para él. ¡Tu Claude también puede tener uno!

Un servidor MCP simple para interactuar con asistentes de OpenAI. Este servidor permite que otras herramientas (como Claude Desktop) creen e interactúen con asistentes de OpenAI a través del Protocolo de Contexto de Modelo.

Características

Este servidor proporciona un conjunto de herramientas para gestionar e interactuar con Asistentes de OpenAI. Las nuevas capacidades de transmisión proporcionan una experiencia de usuario en tiempo real muy mejorada.

Herramientas Disponibles

• create_assistant: (Crear Asistente de OpenAI) - Crear un nuevo asistente con un nombre, instrucciones y modelo.
• list_assistants: (Listar Asistentes de OpenAI) - Listar todos los asistentes disponibles asociados con tu clave de API.
• retrieve_assistant: (Recuperar Asistente de OpenAI) - Obtener información detallada sobre un asistente específico.
• update_assistant: (Actualizar Asistente de OpenAI) - Modificar el nombre, instrucciones o modelo de un asistente existente.
• create_new_assistant_thread: (Crear Nuevo Hilo de Asistente) - Crea un nuevo hilo de conversación persistente con un nombre y descripción definidos por el usuario para facilitar su identificación y reutilización. Esta es la forma recomendada de iniciar una nueva conversación.
• list_threads: (Listar Hilos Gestionados) - Lista todos los hilos de conversación gestionados localmente desde la base de datos, mostrando su ID, nombre, descripción y hora de último uso.
• delete_thread: (Eliminar Hilo Gestionado) - Elimina un hilo de conversación tanto de los servidores de OpenAI como de la base de datos local.
• ask_assistant_in_thread: (Preguntar al Asistente en el Hilo y Transmitir Respuesta) - La herramienta principal para la conversación. Envía un mensaje a un asistente dentro de un hilo y transmite la respuesta en tiempo real.

Debido a que los asistentes de OpenAI pueden tardar bastante en responder, este servidor utiliza un enfoque de transmisión para la herramienta principal ask_assistant_in_thread. Esto proporciona actualizaciones de progreso en tiempo real al cliente y evita tiempos de espera.

El servidor ahora incluye persistencia local para hilos, lo cual es una mejora significativa. Dado que la API de OpenAI no permite listar hilos, este servidor ahora los gestiona por ti almacenando sus IDs y metadatos en una base de datos SQLite local. Esto te permite encontrar, reutilizar y gestionar fácilmente tus hilos de conversación entre sesiones.

Instalación

Instalación mediante Smithery

Para instalar MCP Simple OpenAI Assistant para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install mcp-simple-openai-assistant --client claude

Instalación Manual

pip install mcp-simple-openai-assistant

Configuración

El servidor requiere que se establezca una clave de API de OpenAI en el entorno. Para Claude Desktop, añade esto a tu configuración:

(Versión para MacOS)

{
  "mcpServers": {
    "openai-assistant": {
      "command": "python",
      "args": ["-m", "mcp_simple_openai_assistant"],
      "env": {
        "OPENAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

(Versión para Windows)

"mcpServers": {
  "openai-assistant": {
    "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
      "args": ["-m", "mcp_simple_openai_assistant"],
      "env": {
        "OPENAI_API_KEY": "your-api-key-here"
  }
}

La instalación en MS Windows es ligeramente más compleja, porque necesitas verificar la ruta real a tu ejecutable de Python. La ruta proporcionada arriba suele ser correcta, pero podría diferir en tu configuración. A veces solo python.exe sin ninguna ruta funcionará. Verifica con cmd qué funciona para ti (usar where python podría ayudar). Además, en Windows podrías necesitar indicar explícitamente a Claude Desktop dónde están los paquetes del sitio usando la variable de entorno PYTHONPATH.

Uso

Una vez configurado, puedes usar las herramientas listadas anteriormente para gestionar tus asistentes y conversaciones. El flujo de trabajo principal es:

1. Usar create_new_assistant_thread para iniciar una nueva conversación con nombre.
2. Usar list_threads para encontrar el ID de un hilo que quieras continuar.
3. Usar ask_assistant_in_thread para interactuar con tu asistente elegido en ese hilo.

PENDIENTE

• Añadir Gestión de Hilos: Introducir una forma de nombrar y persistir IDs de hilos localmente, permitiendo una reutilización más fácil de las conversaciones.
• Añadir Listado de Modelos: Introducir una forma para que el usuario de IA vea qué modelos de OpenAI están disponibles para usar con los asistentes.
• Añadir Ajuste Fino de Asistentes: Permitir al usuario de IA establecer parámetros detallados para los asistentes como temperatura, top_p, etc. (indicado por Claude según sea necesario)
• Historial Completo de Hilos: Capacidad de leer hilos pasados sin tener que enviar un nuevo mensaje (indicado por Claude según sea necesario)
• Explorar Soporte de Recursos: Añadir la capacidad de subir archivos y usarlos con los asistentes.

Desarrollo

Para instalar para desarrollo:

git clone https://github.com/andybrandt/mcp-simple-openai-assistant
cd mcp-simple-openai-assistant
pip install -e '.[dev]'