BlueMouse

El "Córtex Prefrontal" para LLMs. Una puerta lógica local basada en datos que entrevista a la IA para prevenir alucinaciones.

GitHub

109

Prueba este MCPPatrocinado

Documentación

🐭 BlueMouse v6.6

La Capa de Seguridad de IA para Cursor y Claude | AI 代碼安全層

Detén el Vibe Coding. Comienza la Ingeniería. | 拒絕憑感覺寫代碼，回歸工程思維。 https://bluemouse.app

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

🌐 Funciona en Todas Partes | 全平台支援

BlueMouse es un servidor MCP estándar que funciona con CUALQUIER cliente compatible con MCP:

Plataforma	Estado	Instalación
🎯 Cursor	✅ Recomendado	Configuración automática con `./Start`
🚀 Antigravity	✅ Compatible	El IDE de IA de Google, listo para MCP
🌊 Windsurf	✅ Compatible	El IDE de IA de Codeium
💬 Claude Desktop	✅ Compatible	Vía Smithery
🌐 Navegador Web	✅ Independiente	¡No necesita IDE! `http://localhost:8001`
🔧 Cualquier Cliente MCP	✅ Compatible	Protocolo MCP estándar

[EN] ¿No tienes Cursor? ¡No hay problema! BlueMouse funciona como una herramienta web independiente.
[中文] 沒有 Cursor？沒關係！BlueMouse 可以當獨立網頁工具使用。

🌟 ¿Por qué BlueMouse? | 為什麼選擇 BlueMouse？

[EN] En la era del Vibe Coding, la IA genera código más rápido de lo que podemos leer. Pero incluso la mejor IA (Claude 3.5 / 4.5) alucina. BlueMouse es tu Airbag. No es otra herramienta de codificación—es una Puerta de Calidad que detiene el código defectuoso antes de que ocurra.

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

El Problema | 問題所在

❌ [EN] La IA genera código "por vibraciones" sin validación lógica profunda
❌ [中文] AI 憑感覺生成代碼，沒有深度邏輯驗證
❌ [EN] Los casos límite se ignoran por completo
❌ [中文] 邊界情況完全沒考慮
❌ [EN] La deuda técnica explota silenciosamente
❌ [中文] 技術債默默爆炸
❌ [EN] Encuentras errores en producción, no en desarrollo
❌ [中文] 在正式環境才發現 Bug，不是在開發階段

La Solución | 解決方案

✅ Validación de 17 Capas | 17層驗證 - Cada línea pasa por análisis AST, verificación de tipos y auditorías de seguridad | 每一行代碼都經過 AST 解析、型別檢查和安全審計
✅ Entrevista Socrática | 蘇格拉底式面試 - La IA debe responder preguntas lógicas antes de generar código | AI 必須先回答邏輯問題才能生成代碼
✅ Costo de Infraestructura Cero | 零基礎設施成本 - 100% ejecución local, sin servidores | 100% 本地執行，不需要伺服器
✅ Inicio con Una Palabra | 一鍵啟動 - Solo escribe "Start" en Cursor | 只需在 Cursor 中輸入 "Start"

🔥 Funciones Principales | 核心功能

🦠 Arquitectura Parásita | 寄生架構

[EN] $0 de costo de infraestructura. BlueMouse se sitúa entre tú y el compilador, interceptando comandos en <10ms. Sin servidores, sin suscripciones, sin dependencias en la nube.

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

🧠 Puerta Lógica Socrática | 蘇格拉底邏輯門

[EN] Antes de escribir código, BlueMouse entrevista a la IA con preguntas críticas:

"¿Para pedidos concurrentes, bloqueo pesimista u optimista?"
"¿Ante un fallo de pago, revertir inmediatamente o reintentar 3 veces?"

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

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

Te obliga (y a la IA) a pensar antes de codificar. | 強制您（和 AI）在寫代碼前先思考。

🛡️ Validación de 17 Capas | 17層驗證

[EN] La generación de código pasa por 17 puertas lógicas:

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

Sintaxis | 語法 - Corrección | 正確性
Tipos | 型別 - Verificación estática de tipos (Pydantic/MyPy) | 靜態型別檢查
Seguridad | 安全 - Escaneo OWASP Top 10 | OWASP Top 10 掃描
Lógica | 邏輯 - Integridad de la lógica de negocio | 業務邏輯完整性
Rendimiento | 性能 - Análisis de complejidad | 複雜度分析 ... y 12 capas más | ...以及另外 12 層

👆 Inicio con Una Palabra | 一鍵啟動

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

BlueMouse inyecta automáticamente .cursorrules y comienza a proteger tu código.

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

📐 Arquitectura del Sistema | 系統架構

[EN] BlueMouse utiliza una arquitectura híbrida de 4 capas con respaldo 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/>文檔+代碼+說明"]

Características Clave | 核心特性:

✅ Cero Puntos Únicos de Fallo | 無單點故障 - Respaldo de 4 capas garantiza 100% de disponibilidad | 4層降級確保 100% 可用性
✅ Offline-Primero | 離線優先 - Funciona sin internet | 無需網路即可運行
✅ BYOK (Trae tu Propia Clave) | 自帶密鑰 - Usa tus propias claves API o modelos locales | 使用您自己的 API 密鑰或本地模型
✅ Base de Conocimiento de 180k | 18萬知識庫 - Precargada con 28 escenarios de alto riesgo | 預載 28 個高風險場景

🏆 Certificación de Grado Industrial | 工業級認證

BlueMouse v6.6 ha superado pruebas de estrés rigurosas | BlueMouse v6.6 已通過嚴格的壓力測試：

Protocolo de Prueba	Estado	Descripción
Protocolo Antártida	✅ APROBADO	100% de funcionalidad en entornos offline/aislados 離線/隔離環境下 100% 功能正常
Prueba Ácida Bilingüe	✅ APROBADO	Cambio dinámico de idioma sin interrupciones (zh-TW / en-US) 無縫動態語言切換（繁中/英文）
Resiliencia de Datos	✅ APROBADO	Validado contra 28 escenarios de alta concurrencia/riesgo financiero 針對 28 個高並發/金融風險場景驗證
Endurecimiento de Seguridad	✅ APROBADO	Protección contra XSS, Inyección SQL, Path Traversal XSS、SQL 注入、路徑遍歷防護
Profundidad de Evaluación	✅ 17 CAPAS	La generación de código pasa por 17 puertas lógicas 代碼生成通過 17 道邏輯閘

🚀 Inicio Rápido | 快速開始

Tres Pasos. Eso es Todo. | 三步驟,就這樣。

# 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 eso es todo. Sin Docker, sin archivos de configuración, sin configuración en la nube.
就這樣。 沒有 Docker、沒有配置檔、沒有雲端設定。

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

¿No tienes Cursor? Abre http://localhost:8001 después de ejecutar ./Start.
沒有 Cursor？執行 ./Start 後打開 http://localhost:8001。

Configuración Detallada | 詳細設定

Para instalación manual o solución de problemas, consulta CURSOR_GUIDE.md.
手動安裝或疑難排解，請參考 CURSOR_GUIDE.md。

📖 Uso | 使用方法

1. Ingresa tu Visión | 輸入您的構想

[EN] Describe lo que quieres construir:

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

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

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

2. Responde Preguntas Socráticas | 回答蘇格拉底式問題

[EN] BlueMouse hará preguntas lógicas críticas:

¿Estrategia de concurrencia de base de datos?
¿Enfoque de manejo de errores?
¿Medidas de seguridad?

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

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

3. Obtén Código Validado | 獲得驗證過的代碼

[EN] Después de pasar 17 capas de validación, descarga el ZIP de tu proyecto que contiene:

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

✅ Código fuente | 原始碼
✅ Diagramas de arquitectura | 架構圖
✅ Guía de instalación | 安裝指南
✅ Estimación de costos | 成本估算
✅ Informe de validación | 驗證報告

🛡️ Seguridad Empresarial | 企業安全

100% Ejecución Local | 100% 本地執行

✅ Ningún dato sale de tu máquina | 數據不離開您的電腦
✅ Sin dependencias en la nube | 無雲端依賴
✅ Sin telemetría ni rastreo | 無遙測或追蹤
✅ Funciona en entornos aislados | 可在隔離環境運行

Licencia AGPLv3 | AGPLv3 授權

✅ Código abierto para transparencia | 開源透明
✅ El uso comercial requiere cumplimiento | 商業使用需遵守協議
✅ Protege contra bifurcaciones de código cerrado | 防止閉源分支

Lee nuestro Libro Blanco de Privacidad para detalles técnicos.

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

🔧 Solución de Problemas | 故障排除

`python3: command not found`

Mac/Linux:

brew install python3

Windows: Descarga desde python.org

`pip install` falla | `pip install` 失敗

Intenta usar un espejo | 嘗試使用鏡像：

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

El puerto 8001 ya está en uso | 端口 8001 已被占用

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

Permiso denegado | 權限被拒絕

chmod +x start_bluemouse.command  # Mac/Linux

`ModuleNotFoundError` | 模組未找到

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

El navegador no se abre | 瀏覽器未打開

Navega manualmente a | 手動訪問: http://localhost:8001

📚 Documentación | 文檔

Arquitectura del Sistema | 系統架構 - Inmersión técnica profunda | 技術深入解析
Registro de Cambios | 更新日誌 - Historial de versiones | 版本歷史
Política de Privacidad | 隱私政策 - Detalles de manejo de datos | 數據處理細節
Licencia | 授權 - Términos AGPLv3 | AGPLv3 條款
Guía de Integración con Cursor | Cursor 整合指南 - Configuración del IDE | IDE 設定

🌍 Comunidad | 社群

GitHub Issues: Reporta errores o solicita funciones | 回報錯誤或請求功能
Discusiones: Únete a la conversación | 加入討論
Correo Electrónico | 電子郵件: bluemouse.ai@gmail.com

🎯 Hoja de Ruta | 路線圖

v6.6 (Actual | 當前版本)

✅ Sistema de validación de 17 capas | 17層驗證系統
✅ Biblioteca de preguntas socráticas (22 preguntas, 10 categorías) | 蘇格拉底問題庫（22 個問題，10 個類別）
✅ Soporte bilingüe (zh-TW / en-US) | 雙語支援（繁中/英文）
✅ Arquitectura parásita de costo cero | 零成本寄生架構

v7.0 (Planificado | 計劃中)

🔄 Generación de plantillas frontend | 前端模板生成
🔄 Biblioteca de preguntas personalizada | 自定義問題庫
🔄 Funciones de colaboración en equipo | 團隊協作功能
🔄 Registros de auditoría empresarial | 企業審計日誌

❓ Preguntas Frecuentes | 常見問題

Q1: ¿Cursor no responde después de iniciar BlueMouse?

A: Por favor verifica los siguientes pasos:

Cierra Cursor completamente (Cmd+Q / Ctrl+Q)
Vuelve a abrir Cursor
Verifica si .vscode/mcp.json existe
Si aún no responde, configura MCP manualmente (consulta CURSOR_GUIDE.md)

Q2: ¿Aparece el error "Address already in use"?

A: El puerto 8001 está ocupado. Solución:

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

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

Q3: ¿CRITICAL STOP no se activa?

A: ¡La función CRITICAL STOP está implementada! Verifica las siguientes condiciones:

Tu solicitud contiene palabras clave como DROP TABLE o DELETE FROM
El servicio de BlueMouse está en ejecución (verifica http://localhost:8001)
Se activará automáticamente durante la fase de preguntas socráticas

Método de prueba:

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

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

Q4: ¿Necesito una API Key?

A: ¡No! BlueMouse puede ejecutarse completamente en local.

Si tienes una API Key de Anthropic/OpenAI, puedes obtener mejor asistencia de IA
Si no, BlueMouse aún ejecutará la Validación de 17 Capas

Q5: ¿Soporta Windows?

A: ¡Sí! Usa Start.bat para iniciar. Nota: Algunas funciones pueden requerir WSL (Subsistema de Windows para Linux)

Q6: ¿Cómo desinstalar?

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

Q7: ¿Puedo usarlo en otros IDEs?

A: ¡Sí! BlueMouse es un servidor MCP estándar, compatible con:

Cursor ✅
Claude Desktop ✅
VS Code (requiere plugin MCP) ✅
Cualquier cliente compatible con el protocolo MCP ✅

📄 Licencia | 授權

BlueMouse está licenciado bajo AGPLv3 | BlueMouse 採用 AGPLv3 授權。

Lo que esto significa | 這意味著:

✅ Gratis para uso personal | 個人使用免費
✅ Gratis para proyectos de código abierto | 開源專案免費
⚠️ El uso comercial requiere cumplimiento (o contáctanos para licenciamiento) | 商業使用需遵守協議（或聯繫我們獲取授權）

Consulta LICENSE para detalles | 詳見 LICENSE。

🙏 Agradecimientos | 致謝

Construido con | 使用以下技術構建:

FastAPI - Framework web moderno de Python | 現代 Python Web 框架
Pydantic - Validación de datos | 數據驗證
Anthropic Claude - Razonamiento de IA (opcional) | AI 推理（可選）
Ollama - Modelos de IA locales (opcional) | 本地 AI 模型（可選）

📊 Estadísticas | 統計

Hecho con ❤️ por desarrolladores que se preocupan por la calidad del código

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

Detén el Vibe Coding. Comienza la Ingeniería. | 拒絕憑感覺寫代碼，回歸工程思維。 🐭