GNB MemoryMCP

Un capa de memoria personal independiente del proveedor (servidor MCP) que puede ser consultada y actualizada de forma común por múltiples LLM y agentes de IA (ChatGPT, Claude, Claude Code, Gemini, Antigravity, etc.).

Este proyecto está implementado en Go y está diseñado para funcionar sin problemas tanto en entornos locales (SQLite) como en producción (AWS Lambda + Turso / libSQL).

Características

• Memoria compartida entre múltiples LLM: Sin estar bloqueado por un proveedor específico, puedes transferir tu configuración, contexto de proyecto y conocimiento a todas las IAs.

• Soporte para dos tipos de conexión local:

  1. Modo servidor HTTP: Se inicia especificando un puerto y se accede desde múltiples clientes. La autenticación utiliza Authorization: Bearer <API_KEY>.

  2. Modo de entrada/salida estándar (stdio): Sin abrir puertos, el binario se ejecuta y comunica directamente desde el cliente MCP, como Claude Desktop.

• Búsqueda de texto completo (FTS5): Soporta búsqueda rápida y ligera de texto completo utilizando FTS5 de SQLite.

• Persistencia del esquema: Almacena tags y metadata como JSON, lo que permite evolucionar la implementación interna (como búsqueda vectorial o lotes de resumen) sin cambiar la especificación de la API.

Estructura de directorios

• cmd/gnb-memorymcp/: Punto de entrada para el binario de integración local (modo server / stdio)

• cmd/lambda/: Punto de entrada para AWS Lambda

• pkg/auth/: Autenticación Bearer, verificación JWT y detección de ID de cliente CIMD

• pkg/domain/: Definiciones de modelos de memoria e interfaces de almacenamiento de base de datos

• pkg/infra/sqlite/: Implementación de almacenamiento en DB, búsqueda de texto completo (FTS5) y sincronización por disparadores con SQLite / libSQL

• pkg/mcp/: Manejador de ejecución de herramientas MCP conforme a JSON-RPC 2.0

Métodos de instalación

Instalación mediante Scoop (recomendado en Windows)

# バケットの追加
scoop bucket add gnb-bucket https://github.com/GennoBou/scoop-bucket

# インストール
scoop install gnb-memorymcp

Compilación desde el código fuente

# 全部入りバイナリ（ローカル用）のビルド
go build -o bin/gnb-memorymcp.exe ./cmd/gnb-memorymcp/main.go

Instrucciones de uso

1. Ejemplo de configuración del modo de entrada/salida estándar (stdio)

Es la forma más sencilla de ejecutar MCP localmente. Registra el binario directamente en el archivo de configuración del cliente (Claude Desktop, Antigravity, OpenCode, etc.) que se conectará. Pasando explícitamente stdio como primer argumento, se iniciará en modo de entrada/salida estándar.

A. Para Claude Desktop

Archivo de configuración: AppData\Roaming\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "gnb-memorymcp": {
      "command": "gnb-memorymcp.exe",
      "args": ["stdio", "--db-url", "file:D:/Data/Projects/GitHub/gnb-memorymcp/data/local_v2.db"]
    }
  }
}

B. Para Antigravity

Archivo de configuración: ~/.gemini/antigravity-cli/settings.json (En Windows: C:\Users\<nombre de usuario>\.gemini\antigravity-cli\settings.json)

{
  "mcpServers": {
    "gnb-memorymcp": {
      "command": "gnb-memorymcp.exe",
      "args": ["stdio", "--db-url", "file:D:/Data/Projects/GitHub/gnb-memorymcp/data/local_v2.db"]
    }
  }
}

C. Para OpenCode

Archivo de configuración: ~/.config/opencode/opencode.jsonc

{
  "mcp": {
    "gnb-memorymcp": {
      "type": "local",
      "enabled": true,
      "command": [
        "gnb-memorymcp.exe",
        "stdio",
        "--db-url",
        "file:D:/Data/Projects/GitHub/gnb-memorymcp/data/local_v2.db"
      ]
    }
  }
}

Después de aplicar la configuración, reinicia el cliente correspondiente para que las herramientas de memoria (memory_create, etc.) se carguen automáticamente y estén disponibles.

2. Modo servidor HTTP (SQLite local)

Inicia como servidor HTTP localmente o en otro terminal, y consulta la base de datos SQLite local. Pasa server como primer argumento para iniciar. Por seguridad, por defecto se vincula a localhost (127.0.0.1).

Método de inicio (PowerShell)

• Método 1: Iniciar especificando argumentos de comando

  # ローカルホストからのみ接続可能として起動 (APIキーが未指定の場合は自動的に 'dev-key' が使われます)
  ./bin/gnb-memorymcp.exe server --port 8080 --db-url "file:data/local_v2.db"
  
  # 外部ネットワークに公開して起動 (--host 0.0.0.0 指定時は、安全な独自の --api-key 設定が必須)
  ./bin/gnb-memorymcp.exe server --host 0.0.0.0 --port 8080 --api-key "your-secure-secret-key" --db-url "file:data/local_v2.db"

• Método 2: Iniciar especificando variables de entorno

  $env:HOST="127.0.0.1"
  $env:API_KEY="your-secret-key"
  $env:PORT="8080"
  $env:DB_URL="file:data/local_v2.db"
  ./bin/gnb-memorymcp.exe server

Método de solicitud desde el cliente

• URL: http://localhost:8080/

• Método: POST

• Encabezado requerido: Authorization: Bearer your-secret-key

• Cuerpo de la solicitud (JSON-RPC 2.0):

  {
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
  }

3. Modo HTTP local + Turso (conexión a DB en la nube)

Inicia un servidor HTTP localmente, pero solo la base de datos se refiere al Turso remoto (libSQL).

Método de inicio (PowerShell)

• Método 1: Iniciar especificando argumentos de comando ※ Se recomienda configurar DB_TOKEN como variable de entorno por seguridad.

  $env:DB_TOKEN="your-turso-auth-token"
  ./bin/gnb-memorymcp.exe server --port 8080 --api-key "your-secret-key" --db-url "libsql://your-database-name-username.turso.io"

• Método 2: Iniciar especificando variables de entorno

  $env:API_KEY="your-secret-key"
  $env:PORT="8080"
  $env:DB_URL="libsql://your-database-name-username.turso.io"
  $env:DB_TOKEN="your-turso-auth-token"
  ./bin/gnb-memorymcp.exe server

4. Modo AWS Lambda + Turso (operación en la nube de producción)

Configuración para desplegar sin servidor en AWS Lambda y operar en conjunto con Turso.

• Punto de entrada: cmd/lambda/main.go

• Soporta scripts de compilación e implementación en un solo comando (npm run build-and-deploy-lambda) y plantillas SAM (template.yaml).

Para obtener instrucciones detalladas de implementación, consulta las Instrucciones de implementación de AWS Lambda + Turso.

Especificaciones de las herramientas MCP proporcionadas

GNB MemoryMCP ofrece las siguientes 10 herramientas.