Interact MCP

Interact MCP

Um servidor MCP (Model Context Protocol) interativo que permite comunicação em tempo real entre assistentes de IA e usuários por meio de uma interface de chat baseada na web.

Visão Geral

Este projeto fornece um servidor MCP com uma ferramenta interact que permite que assistentes de IA:

• Façam perguntas e recebam respostas dos usuários
• Solicitem confirmação para ações
• Busquem orientação ou esclarecimentos
• Compartilhem informações em tempo real

O servidor possui uma interface web baseada em Gradio que fornece uma UI de chat para interação perfeita com o usuário.

Recursos

• Interação em Tempo Real: Comunicação bidirecional entre IA e usuários
• Interface de Chat Baseada na Web: UI limpa e moderna alimentada por Gradio
• Múltiplas Opções de Transporte: Suporta transporte stdio e SSE (Server-Sent Events)
• Tratamento de Timeout: Proteção automática de timeout para respostas do usuário
• Histórico de Chat: Mantém o histórico da conversa durante as sessões

Instalação

1. Clone este repositório:

git clone <repository-url>
cd interact-mcp

2. Crie e ative um ambiente virtual:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Instale as dependências:

pip install fastmcp gradio

Uso

Executando o Servidor

Opção 1: Transporte SSE (Padrão)

python server.py

Isso iniciará o servidor em 127.0.0.1:3033 e abrirá automaticamente a interface de chat no seu navegador.

Opção 2: Porta Personalizada

python server.py sse 8080

Especifique uma porta personalizada para o transporte SSE.

Opção 3: Transporte Stdio

python server.py --stdio

Use o transporte stdio para comunicação MCP direta.

Usando a Interface de Chat

1. A interface web abrirá automaticamente no seu navegador
2. Aguarde as mensagens do assistente de IA aparecerem
3. Responda a perguntas ou solicitações no campo de entrada de texto
4. Suas respostas serão enviadas de volta ao assistente de IA através do protocolo MCP

Adicionando ao Cursor IDE

Para usar este servidor MCP com o Cursor IDE, você precisará configurá-lo no arquivo de configuração do MCP.

1. Abra o Cursor IDE e vá para Cursor Settings > Tools & Integrations e clique em "New MCP Server"
2. Isso abrirá o arquivo ~/.cursor/mcp.json para edição
3. Adicione a seguinte configuração:

{
    "mcpServers": {
        "interact": {
            "command": "path/to/interact-mcp/venv/bin/python3",
            "args": ["path/to/interact-mcp/server.py", "--stdio"]
        }
    }
}

4. Substitua path/to/interact-mcp pelo caminho real do diretório do seu projeto
5. A UI do Gradio deve abrir automaticamente no seu navegador

Ferramenta MCP

interact(message: str) -> str

A principal ferramenta fornecida por este servidor permite que assistentes de IA interajam com os usuários.

Parâmetros:

• message (str): A mensagem a ser enviada ao usuário

Retornos:

• str: A resposta do usuário à mensagem

Timeout:

• O timeout padrão é de 5 minutos (300 segundos)
• Retorna uma mensagem de timeout se nenhuma resposta for recebida

Construindo Executável

Um arquivo de especificação PyInstaller está incluído para criar executáveis autônomos:

pyinstaller server.spec

Isso criará um executável dist/server que inclui todas as dependências necessárias.

Detalhes Técnicos

• Construído com o framework FastMCP
• Usa Gradio para a interface web
• Implementa threading para operação concorrente da UI web e do servidor MCP
• Suporta atualizações em tempo real com mecanismo de atualização periódica

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar issues ou pull requests.