MCP Simple OpenAI Assistant

MCP Simple OpenAI Assistant

Assistentes de IA são bem legais. Pensei que seria uma boa ideia se meu Claude (Claude consciente) também tivesse um. E agora ele tem — e é útil e divertido para ele. Seu Claude também pode ter um!

Um servidor MCP simples para interagir com assistentes da OpenAI. Este servidor permite que outras ferramentas (como o Claude Desktop) criem e interajam com assistentes da OpenAI através do Model Context Protocol.

Recursos

Este servidor fornece um conjunto de ferramentas para gerenciar e interagir com Assistentes da OpenAI. As novas capacidades de streaming proporcionam uma experiência do usuário muito melhorada e em tempo real.

Ferramentas Disponíveis

• create_assistant: (Criar Assistente OpenAI) - Crie um novo assistente com nome, instruções e modelo.
• list_assistants: (Listar Assistentes OpenAI) - Liste todos os assistentes disponíveis associados à sua chave de API.
• retrieve_assistant: (Recuperar Assistente OpenAI) - Obtenha informações detalhadas sobre um assistente específico.
• update_assistant: (Atualizar Assistente OpenAI) - Modifique o nome, instruções ou modelo de um assistente existente.
• create_new_assistant_thread: (Criar Nova Thread de Assistente) - Cria uma nova thread de conversa persistente com nome e descrição definidos pelo usuário para fácil identificação e reutilização. Esta é a forma recomendada de iniciar uma nova conversa.
• list_threads: (Listar Threads Gerenciadas) - Lista todas as threads de conversa gerenciadas localmente no banco de dados, mostrando seu ID, nome, descrição e último uso.
• delete_thread: (Excluir Thread Gerenciada) - Exclui uma thread de conversa tanto dos servidores da OpenAI quanto do banco de dados local.
• ask_assistant_in_thread: (Perguntar ao Assistente na Thread e Transmitir Resposta) - A ferramenta principal para conversas. Envia uma mensagem a um assistente dentro de uma thread e transmite a resposta em tempo real.

Como os assistentes da OpenAI podem demorar bastante para responder, este servidor usa uma abordagem de streaming para a principal ferramenta ask_assistant_in_thread. Isso fornece atualizações de progresso em tempo real ao cliente e evita timeouts.

O servidor agora inclui persistência local para threads, o que é uma melhoria significativa. Como a API da OpenAI não permite listar threads, este servidor agora as gerencia para você, armazenando seus IDs e metadados em um banco de dados SQLite local. Isso permite que você encontre, reutilize e gerencie facilmente suas threads de conversa entre sessões.

Instalação

Instalando via Smithery

Para instalar o MCP Simple OpenAI Assistant para Claude Desktop automaticamente via Smithery:

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

Instalação Manual

pip install mcp-simple-openai-assistant

Configuração

O servidor requer uma chave de API da OpenAI definida no ambiente. Para o Claude Desktop, adicione isto à sua configuração:

(Versão MacOS)

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

(Versão 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"
  }
}

A instalação no MS Windows é um pouco mais complexa, pois você precisa verificar o caminho real para o seu executável Python. O caminho fornecido acima geralmente está correto, mas pode diferir na sua configuração. Às vezes, apenas python.exe sem nenhum caminho resolve. Verifique com cmd o que funciona para você (usar where python pode ajudar). Além disso, no Windows, você pode precisar informar explicitamente ao Claude Desktop onde estão os pacotes do site usando a variável de ambiente PYTHONPATH.

Uso

Uma vez configurado, você pode usar as ferramentas listadas acima para gerenciar seus assistentes e conversas. O fluxo de trabalho principal é:

1. Use create_new_assistant_thread para iniciar uma nova conversa nomeada.
2. Use list_threads para encontrar o ID de uma thread que você deseja continuar.
3. Use ask_assistant_in_thread para interagir com o assistente escolhido nessa thread.

TODO

• Adicionar Gerenciamento de Threads: Introduzir uma forma de nomear e persistir IDs de threads localmente, permitindo reutilização mais fácil de conversas.
• Adicionar Listagem de Modelos: Introduzir uma forma de o usuário de IA ver quais modelos da OpenAI estão disponíveis para uso com os assistentes
• Adicionar Ajuste Fino de Assistentes: Permitir que o usuário de IA defina parâmetros detalhados para assistentes como temperatura, top_p etc. (indicado por Claude conforme necessário)
• Histórico Completo de Threads: Capacidade de ler threads passadas sem ter que enviar uma nova mensagem (indicado por Claude conforme necessário)
• Explorar Suporte a Recursos: Adicionar a capacidade de enviar arquivos e usá-los com assistentes.

Desenvolvimento

Para instalar para desenvolvimento:

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