BlueMouse

O "Córtex Pré-frontal" para LLMs. Um portão lógico local e orientado a dados que entrevista a IA para prevenir alucinações.

GitHub
109
Experimente este MCPPatrocinado

Documentação

🐭 BlueMouse v6.6

A Camada de Segurança de IA para Cursor & Claude | AI 代碼安全層

Pare de Codar por Intuição. Comece a Engenhar. | 拒絕憑感覺寫代碼，回歸工程思維。 https://bluemouse.app

Glama | bluemouse Smithery | bluemouse Status License

Privacy Compatible

Contato | 聯繫: bluemouse.ai@gmail.com

🌐 Funciona em Qualquer Lugar | 全平台支援

BlueMouse é um servidor MCP padrão que funciona com QUALQUER cliente compatível com MCP:

PlataformaStatusInstalação
🎯 Cursor✅ RecomendadoConfiguração automática com ./Start
🚀 Antigravity✅ SuportadoIDE de IA do Google, pronto para MCP
🌊 Windsurf✅ SuportadoIDE de IA da Codeium
💬 Claude Desktop✅ SuportadoVia Smithery
🌐 Navegador Web✅ IndependenteSem IDE necessário! http://localhost:8001
🔧 Qualquer Cliente MCP✅ CompatívelProtocolo MCP padrão

[EN] Não tem Cursor? Sem problema! BlueMouse funciona como uma ferramenta web independente.
[中文] 沒有 Cursor？沒關係！BlueMouse 可以當獨立網頁工具使用。

🌟 Por que BlueMouse? | 為什麼選擇 BlueMouse？

[EN] Na era do Vibe Coding, a IA gera código mais rápido do que conseguimos ler. Mas até a melhor IA (Claude 3.5 / 4.5) tem alucinações. BlueMouse é o seu Airbag. Não é apenas mais uma ferramenta de codificação—é um Portão de Qualidade que impede código ruim antes que ele aconteça.

[中文] 在 Vibe Coding 盛行的時代，AI 產生代碼的速度比我們閱讀的速度還快。但即使是最強的 AI (Claude 3.5 / 4.5) 也會出現邏輯幻覺。BlueMouse 是您的安全氣囊。 它不是另一個寫代碼的工具，它是阻止爛代碼發生的守門員。

O Problema | 問題所在

  • ❌ [EN] A IA gera código por "intuição" sem validação lógica profunda
  • ❌ [中文] AI 憑感覺生成代碼，沒有深度邏輯驗證
  • ❌ [EN] Casos de borda são completamente ignorados
  • ❌ [中文] 邊界情況完全沒考慮
  • ❌ [EN] A dívida técnica explode silenciosamente
  • ❌ [中文] 技術債默默爆炸
  • ❌ [EN] Você encontra bugs em produção, não no desenvolvimento
  • ❌ [中文] 在正式環境才發現 Bug，不是在開發階段

A Solução | 解決方案

  • ✅ Validação em 17 Camadas | 17層驗證 - Cada linha passa por análise AST, verificação de tipos e auditorias de segurança | 每一行代碼都經過 AST 解析、型別檢查和安全審計
  • ✅ Entrevista Socrática | 蘇格拉底式面試 - A IA deve responder perguntas lógicas antes de gerar código | AI 必須先回答邏輯問題才能生成代碼
  • ✅ Custo de Infraestrutura Zero | 零基礎設施成本 - 100% execução local, sem servidores necessários | 100% 本地執行，不需要伺服器
  • ✅ Início com Uma Palavra | 一鍵啟動 - Basta digitar "Start" no Cursor | 只需在 Cursor 中輸入 "Start"

🔥 Recursos Principais | 核心功能

🦠 Arquitetura Parasitária | 寄生架構

[EN] Custo de Infraestrutura de $0. BlueMouse fica entre você e o compilador, interceptando comandos em <10ms. Sem servidores, sem assinaturas, sem dependências de nuvem.

[中文] $0 營運成本。BlueMouse 寄生於您的開發環境，以 <10ms 的速度攔截指令。無需伺服器、訂閱或雲端依賴。

🧠 Portão Lógico Socrático | 蘇格拉底邏輯門

[EN] Antes de escrever código, BlueMouse entrevista a IA com perguntas críticas:

  • "Para pedidos concorrentes, lock pessimista ou lock otimista?"
  • "Em falha de pagamento, reverter imediatamente ou tentar 3 vezes?"

[中文] 在寫代碼之前，BlueMouse 會用關鍵問題面試 AI：

  • 「對於並發訂單，使用悲觀鎖還是樂觀鎖？」
  • 「支付失敗時，立即回滾還是重試 3 次？」

Força você (e a IA) a pensar antes de codificar. | 強制您（和 AI）在寫代碼前先思考。

🛡️ Validação em 17 Camadas | 17層驗證

[EN] A geração de código passa por 17 portões lógicos:

[中文] 代碼生成必須通過 17 道邏輯閘：

  1. Sintaxe | 語法 - Correção | 正確性
  2. Tipos | 型別 - Verificação estática de tipos (Pydantic/MyPy) | 靜態型別檢查
  3. Segurança | 安全 - Varredura OWASP Top 10 | OWASP Top 10 掃描
  4. Lógica | 邏輯 - Integridade da lógica de negócios | 業務邏輯完整性
  5. Desempenho | 性能 - Análise de complexidade | 複雜度分析 ... e mais 12 camadas | ...以及另外 12 層

👆 Início com Uma Palavra | 一鍵啟動

# Just drag the folder into Cursor and type:
# 只需將資料夾拖進 Cursor 並輸入：
Start

BlueMouse injeta automaticamente .cursorrules e começa a proteger seu código.

BlueMouse 會自動注入 .cursorrules 並開始保護您的代碼。

📐 Arquitetura do Sistema | 系統架構

[EN] BlueMouse usa uma arquitetura híbrida de 4 camadas com fallback inteligente:

[中文] BlueMouse 使用 4 層混合架構,具有智能降級機制:

graph TD
    User["User Request | 用戶需求"] --> L1{"L1: Antigravity Inline<br/>內聯生成"}
    L1 -->|Miss 未命中| L2{"L2: Ollama Local<br/>本地模型"}
    L2 -->|Miss/Timeout<br/>未命中/超時| L3{"L3: Cloud API (BYOK)<br/>雲端 API (自帶密鑰)"}
    L3 -->|Miss/Offline<br/>未命中/離線| L4["L4: Rule Engine Fallback<br/>規則引擎降級"]
    
    subgraph "Hybrid Fusion Core | 混合融合核心"
    L4 -->|Keyword Match<br/>關鍵詞匹配| KB["Knowledge Base (180k Data)<br/>知識庫 (18萬數據)"]
    KB --> Fusion["Hybrid Fusion Engine<br/>混合融合引擎"]
    end
    
    Fusion --> Socratic["Socratic Interview<br/>蘇格拉底式面試"]
    Socratic --> User
    
    User -->|Answers 回答| CodeGen["17-Layer Code Generator<br/>17層代碼生成器"]
    CodeGen -->|Compiler Prompt<br/>編譯器提示| README["README+Code+Docs<br/>文檔+代碼+說明"]

Recursos Principais | 核心特性:

  • ✅ Zero Ponto Único de Falha | 無單點故障 - Fallback de 4 camadas garante 100% de disponibilidade | 4層降級確保 100% 可用性
  • ✅ Offline-Primeiro | 離線優先 - Funciona sem internet | 無需網路即可運行
  • ✅ BYOK (Traga Sua Própria Chave) | 自帶密鑰 - Use suas próprias chaves de API ou modelos locais | 使用您自己的 API 密鑰或本地模型
  • ✅ Base de Conhecimento de 180k | 18萬知識庫 - Pré-carregada com 28 cenários de alto risco | 預載 28 個高風險場景

🏆 Certificação de Grau Industrial | 工業級認證

BlueMouse v6.6 passou em testes de estresse rigorosos | BlueMouse v6.6 已通過嚴格的壓力測試：

Protocolo de TesteStatusDescrição
Protocolo Antártica✅ APROVADO100% de funcionalidade em ambientes offline/isolados
離線/隔離環境下 100% 功能正常
Teste Ácido Bilíngue✅ APROVADOAlternância dinâmica de idiomas sem interrupções (zh-TW / en-US)
無縫動態語言切換（繁中/英文）
Resiliência de Dados✅ APROVADOValidado contra 28 cenários de alta concorrência/risco financeiro
針對 28 個高並發/金融風險場景驗證
Endurecimento de Segurança✅ APROVADOProteção contra XSS, Injeção SQL, Path Traversal
XSS、SQL 注入、路徑遍歷防護
Profundidade de Verificação✅ 17 CAMADASGeração de código canalizada por 17 portões lógicos
代碼生成通過 17 道邏輯閘

🚀 Início Rápido | 快速開始

Três Passos. Só Isso. | 三步驟,就這樣。

# 1. Clone
git clone https://github.com/peijun1700/bluemouse
cd bluemouse

# 2. Start (在終端機執行 | Run in Terminal)
./Start        # Mac/Linux
Start.bat      # Windows

# 3. Restart Cursor
# BlueMouse is now protecting your code!

É literalmente só isso. Sem Docker, sem arquivos de configuração, sem configuração de nuvem.
就這樣。 沒有 Docker、沒有配置檔、沒有雲端設定。

Alternativa: Use como Ferramenta Web | 替代方案：當網頁工具用

Não tem Cursor? Abra http://localhost:8001 após executar ./Start.
沒有 Cursor？執行 ./Start 後打開 http://localhost:8001。

Configuração Detalhada | 詳細設定

Para instalação manual ou solução de problemas, consulte CURSOR_GUIDE.md.
手動安裝或疑難排解，請參考 CURSOR_GUIDE.md。

📖 Uso | 使用方法

1. Insira Sua Visão | 輸入您的構想

[EN] Descreva o que você quer construir:

I want to build an e-commerce platform with user authentication

[中文] 描述您想建立的系統：

我想做一個電商平台，有用戶認證功能

2. Responda às Perguntas Socráticas | 回答蘇格拉底式問題

[EN] BlueMouse fará perguntas lógicas críticas:

  • Estratégia de concorrência de banco de dados?
  • Abordagem de tratamento de erros?
  • Medidas de segurança?

[中文] BlueMouse 會詢問關鍵邏輯問題：

  • 資料庫並發策略？
  • 錯誤處理方式？
  • 安全措施？

3. Obtenha Código Validado | 獲得驗證過的代碼

[EN] Após passar pelas 17 camadas de validação, baixe o ZIP do seu projeto contendo:

[中文] 通過 17 層驗證後，下載包含以下內容的專案 ZIP：

  • ✅ Código-fonte | 原始碼
  • ✅ Diagramas de arquitetura | 架構圖
  • ✅ Guia de instalação | 安裝指南
  • ✅ Estimativa de custos | 成本估算
  • ✅ Relatório de validação | 驗證報告

🛡️ Segurança Empresarial | 企業安全

100% Execução Local | 100% 本地執行

  • ✅ Nenhum dado sai da sua máquina | 數據不離開您的電腦
  • ✅ Sem dependências de nuvem | 無雲端依賴
  • ✅ Sem telemetria ou rastreamento | 無遙測或追蹤
  • ✅ Funciona em ambientes isolados | 可在隔離環境運行

Licença AGPLv3 | AGPLv3 授權

  • ✅ Código aberto para transparência | 開源透明
  • ✅ Uso comercial exige conformidade | 商業使用需遵守協議
  • ✅ Protege contra forks de código fechado | 防止閉源分支

Leia nosso Whitepaper de Privacidade para detalhes técnicos.

**閱讀我們的隱私白皮書**了解技術細節。

🔧 Solução de Problemas | 故障排除

python3: command not found

Mac/Linux:

brew install python3

Windows: Baixe de python.org

pip install falha | pip install 失敗

Tente usar um espelho | 嘗試使用鏡像：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

Porta 8001 já em uso | 端口 8001 已被占用

# Find and kill the process | 查找並終止進程
lsof -ti:8001 | xargs kill -9  # Mac/Linux
netstat -ano | findstr :8001   # Windows

Permissão negada | 權限被拒絕

chmod +x start_bluemouse.command  # Mac/Linux

ModuleNotFoundError | 模組未找到

pip install -r requirements.txt --force-reinstall

O navegador não abre | 瀏覽器未打開

Navegue manualmente para | 手動訪問: http://localhost:8001

📚 Documentação | 文檔

🌍 Comunidade | 社群

🎯 Roteiro | 路線圖

v6.6 (Atual | 當前版本)

  • ✅ Sistema de validação em 17 camadas | 17層驗證系統
  • ✅ Biblioteca de perguntas socráticas (22 perguntas, 10 categorias) | 蘇格拉底問題庫（22 個問題，10 個類別）
  • ✅ Suporte bilíngue (zh-TW / en-US) | 雙語支援（繁中/英文）
  • ✅ Arquitetura parasitária de custo zero | 零成本寄生架構

v7.0 (Planejado | 計劃中)

  • 🔄 Geração de templates de frontend | 前端模板生成
  • 🔄 Biblioteca de perguntas personalizadas | 自定義問題庫
  • 🔄 Recursos de colaboração em equipe | 團隊協作功能
  • 🔄 Logs de auditoria empresarial | 企業審計日誌

❓ FAQ | 常見問題

Q1: Após iniciar o BlueMouse, o Cursor não responde?

A: Por favor, verifique os seguintes passos:

  1. Feche completamente o Cursor (Cmd+Q / Ctrl+Q)
  2. Reabra o Cursor
  3. Verifique se .vscode/mcp.json existe
  4. Se ainda não responder, configure o MCP manualmente (consulte CURSOR_GUIDE.md)

Q2: Aparece o erro "Address already in use"?

A: A porta 8001 está ocupada. Solução:

# Mac/Linux
lsof -ti:8001 | xargs kill -9

# Windows
netstat -ano | findstr :8001
taskkill /PID <PID> /F

Q3: O CRITICAL STOP não foi acionado?

A: O recurso CRITICAL STOP está implementado! Verifique as seguintes condições:

  • Sua solicitação contém palavras-chave como DROP TABLE ou DELETE FROM
  • O serviço BlueMouse está em execução (verifique http://localhost:8001)
  • Será acionado automaticamente na fase de perguntas socráticas

Método de teste:

# 在需求輸入框輸入:
"幫我 drop table users"

# 系統會立即顯示:
⚠️ CRITICAL STOP: You are executing DROP without Environment Check. 
Is this PROD?

Q4: Preciso de uma chave de API?

A: Não! BlueMouse pode funcionar totalmente localmente.

  • Se você tiver uma chave de API Anthropic/OpenAI, pode obter melhor assistência de IA
  • Se não tiver, BlueMouse ainda executará a Validação em 17 Camadas

Q5: Suporta Windows?

A: Suporta! Use Start.bat para iniciar. Nota: Alguns recursos podem exigir WSL (Subsistema Windows para Linux)

Q6: Como desinstalar?

A:

# 1. 停止服務 (Ctrl+C)
# 2. 刪除資料夾
rm -rf bluemouse
# 3. 移除 Cursor 配置
rm .vscode/mcp.json

Q7: Posso usar em outros IDEs?

A: Pode! BlueMouse é um servidor MCP padrão, suporta:

  • Cursor ✅
  • Claude Desktop ✅
  • VS Code (requer plugin MCP) ✅
  • Qualquer cliente que suporte o protocolo MCP ✅

📄 Licença | 授權

BlueMouse é licenciado sob AGPLv3 | BlueMouse 採用 AGPLv3 授權。

O que isso significa | 這意味著:

  • ✅ Gratuito para uso pessoal | 個人使用免費
  • ✅ Gratuito para projetos de código aberto | 開源專案免費
  • ⚠️ Uso comercial exige conformidade (ou entre em contato para licenciamento) | 商業使用需遵守協議（或聯繫我們獲取授權）

Consulte LICENSE para detalhes | 詳見 LICENSE。

🙏 Agradecimentos | 致謝

Construído com | 使用以下技術構建:

  • FastAPI - Framework web moderno em Python | 現代 Python Web 框架
  • Pydantic - Validação de dados | 數據驗證
  • Anthropic Claude - Raciocínio de IA (opcional) | AI 推理（可選）
  • Ollama - Modelos de IA locais (opcional) | 本地 AI 模型（可選）

📊 Estatísticas | 統計

GitHub stars GitHub forks GitHub watchers

Feito com ❤️ por desenvolvedores que se importam com a qualidade do código

由關心代碼品質的開發者用心打造

Pare de Codar por Intuição. Comece a Engenhar. | 拒絕憑感覺寫代碼，回歸工程思維。 🐭