AskMeMCP

Permite que assistentes de IA solicitem entrada humana por meio de uma interface web, facilitando interações com supervisão humana.

GitHub

Experimente este MCPPatrocinado

Documentação

AskMeMCP - Servidor MCP com Intervenção Humana

O AskMeMCP é um servidor de Protocolo de Contexto de Modelo (MCP) que permite que assistentes de IA solicitem entrada humana por meio de uma interface web. Ele implementa múltiplas ferramentas interativas (ask-one-question, ask-multiple-choice, challenge-hypothesis, choose-next), permitindo que clientes MCP como o Claude Code pausem a execução e aguardem respostas humanas.

Recursos

Transporte stdio: Integração direta com Claude Code e outros clientes MCP
Servidor Autocontido: Serve a interface Angular estaticamente - sem necessidade de servidor de UI separado
Alocação Dinâmica de Porta: Encontra automaticamente uma porta disponível se a padrão estiver em uso
Abertura Automática do Navegador: Abre a UI automaticamente quando as solicitações chegam
Atualizações em Tempo Real: Eventos enviados pelo servidor para comunicação ao vivo
Múltiplos Tipos de Ferramentas: Perguntas únicas, múltipla escolha, desafios de hipóteses e fluxos de decisão

Instalação

Opção 1: Usando npx (Sem Necessidade de Instalação)

Você pode executar o Ask-Me MCP diretamente usando npx sem instalá-lo globalmente:

npx ask-me-mcp

Nota: Na primeira vez que você executar isso, o npx pedirá confirmação para instalar o pacote temporariamente. Para pular essa confirmação, use:

npx --yes ask-me-mcp

Opção 2: Instalação Global

npm install -g ask-me-mcp
ask-me-mcp

Configuração para Diferentes Clientes

Aplicativo de Desktop Claude

Adicione ao seu arquivo de configuração do Claude:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ask-me": {
      "command": "npx",
      "args": ["--yes", "ask-me-mcp"]
    }
  }
}

Claude Code

Usando a CLI:

claude mcp add askme -- npx -y ask-me-mcp

Ou adicione manualmente à sua configuração do Claude Code:

macOS: ~/Library/Application Support/Claude/claude_code_config.json
Windows: %APPDATA%\Claude\claude_code_config.json
Linux: ~/.config/Claude/claude_code_config.json

{
  "mcpServers": {
    "ask-me": {
      "command": "npx",
      "args": ["--yes", "ask-me-mcp"]
    }
  }
}

Cursor

Adicione às configurações do seu Cursor (em .cursor/mcp_settings.json na raiz do seu projeto):

{
  "mcpServers": {
    "ask-me": {
      "command": "npx",
      "args": ["--yes", "ask-me-mcp"]
    }
  }
}

VS Code com Continue ou Extensões Similares

Para extensões do VS Code que suportam MCP, adicione à configuração da sua extensão:

{
  "mcpServers": {
    "ask-me": {
      "command": "npx",
      "args": ["--yes", "ask-me-mcp"]
    }
  }
}

Configuração de Porta

O servidor tem dois comportamentos de porta:

Descoberta automática (padrão): Encontra uma porta disponível a partir de 3000
```
npx --yes ask-me-mcp
```
Porta fixa: Usa a porta exata especificada com --port (falha se a porta estiver em uso)
```
npx --yes ask-me-mcp --port 8080
```

Para configuração do Claude Code com porta fixa:

{
  "mcpServers": {
    "ask-me": {
      "command": "npx",
      "args": ["--yes", "ask-me-mcp", "--port", "8080"]
    }
  }
}

Opção 3: Compilar a partir do Código-Fonte

# Clone the repository
git clone https://github.com/yourusername/AskMeMCP.git
cd AskMeMCP

# Install dependencies
npm install

# Build all projects
npm run build

# Configure Claude Code with full path

Adicione à sua configuração do Claude Code:

{
  "mcpServers": {
    "ask-me": {
      "command": "node",
      "args": ["/full/path/to/AskMeMCP/dist/askme-server/main.js"]
    }
  }
}

Uso

Uma vez configurado, você pode usar as ferramentas disponíveis no Claude Code:

Ferramenta ask-one-question

Please use the ask-one-question tool to ask me what my favorite color is

Ferramenta ask-multiple-choice

Please use the ask-multiple-choice tool with these questions:
{
  "questions": [
    {
      "text": "Which deployment environments should we target?",
      "options": ["Development", "Staging", "Production"]
    },
    {
      "text": "Which features should be included in this release?",
      "options": ["User Authentication", "Dashboard Updates", "API Improvements", "Mobile Support"]
    }
  ]
}

Todas as solicitações aparecerão na interface web, onde você pode fornecer respostas. Para perguntas de múltipla escolha, você pode selecionar várias opções e adicionar comentários a cada escolha.

Arquitetura

askme-server: Servidor MCP stdio com ponte HTTP incorporada para comunicação com o navegador
askme-ui: Frontend Angular 20+ com UI reativa usando signals
askme-shared: Tipos TypeScript compartilhados para comunicação frontend-backend

Desenvolvimento

# Run the UI in development mode
npx nx serve askme-ui

# Run the server in development mode
npx nx serve askme-server

# Run tests
npx nx test askme-ui
npx nx test askme-server

# Lint code
npx nx lint askme-ui
npx nx lint askme-server

Solução de Problemas

Problemas de Conexão com o Claude Code

Se você vir erros de "Falha na conexão":

Ative o Modo de Depuração: Execute com registro de depuração para ver o que está acontecendo:
```
ASK_ME_MCP_DEBUG=1 claude --debug
```
Verifique o Servidor: Teste se o servidor executa corretamente:
```
npx --yes ask-me-mcp --help
```
Conflitos de Porta: Se a porta 3000 estiver em uso, especifique uma porta diferente:
```
claude mcp add ask-me npx --yes ask-me-mcp --port 8080
```
Teste Manual: Execute o servidor diretamente para ver quaisquer erros:
```
npx --yes ask-me-mcp
```

Problemas Comuns

Confirmação na Primeira Vez: A primeira execução de npx ask-me-mcp pode pedir confirmação. Use npx --yes para pular isso.
Porta Já em Uso: O servidor encontra automaticamente uma porta disponível, mas você pode especificar uma com --port
Navegador Não Abre: Se o navegador não abrir automaticamente, navegue manualmente para a porta mostrada nos registros de depuração

Licença

MIT