Skip to main content
Glama
deenesjakoruzh
bwats

lifeos-mcp

by bwats
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

LifeOS MCP

Dale a cualquier agente de IA acceso de lectura a tu base de conocimientos LifeOS: Claude Desktop, Claude Code, Cursor, ChatGPT, Codex o cualquier cliente compatible con MCP.

El servidor lee desde ~/lifeos/ y muestra todo a través de URIs de recursos lifeos:// y nombres de herramientas lifeos__*.

Instalación

Una vez publicado (próximamente)

npx lifeos-mcp

Desde el código fuente (ahora)

git clone https://github.com/bwats/lifeos-mcp
cd lifeos-mcp
npm install && npm run build
node bin/lifeos-mcp.js

Instalación global desde el código fuente

cd ~/lifeos-mcp
npm install -g .
lifeos-mcp  # starts the MCP server on stdio

Qué expone

lifeos-mcp otorga a cualquier cliente de IA compatible con MCP acceso directo de lectura a:

Superficie

Ruta en ~/lifeos/

Herramienta

Identidad

identity.md

lifeos__get_identity

Preferencias

preferences.md

lifeos__get_preferences

Habilidades

skills/*/

lifeos__list_skills, lifeos__read_skill

Proyectos

projects/*.md

lifeos__list_projects, lifeos__read_project

Wiki

wiki/pages/**/*.md

lifeos__list_wiki_pages, lifeos__read_wiki_page

Reglas

system/*.md

lifeos__list_rules, lifeos__read_rule

Cualquier archivo

(ruta segura)

lifeos__read_file

Búsqueda

(texto completo)

lifeos__search

Modos

Invocación

Qué sucede

lifeos-mcp

Inicia el servidor MCP en stdio (predeterminado)

lifeos-mcp --stdio

Inicia el servidor MCP en stdio (explícito)

lifeos-mcp list

Lista los rituales en ~/lifeos/cadence/rituals/

lifeos-mcp validate <ritual.md>

Valida un archivo de especificación de ritual

lifeos-mcp render <ritual.md> --to <harness>

Renderiza el ritual a un arnés de destino

lifeos-mcp --help

Muestra todos los subcomandos y opciones

Configurar clientes MCP

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "lifeos": {
      "command": "npx",
      "args": ["lifeos-mcp"]
    }
  }
}

O desde el código fuente:

{
  "mcpServers": {
    "lifeos": {
      "command": "node",
      "args": ["/Users/yourname/lifeos-mcp/bin/lifeos-mcp.js"]
    }
  }
}

Cursor (settings.json)

{
  "mcpServers": {
    "lifeos": {
      "command": "node",
      "args": ["/Users/yourname/lifeos-mcp/bin/lifeos-mcp.js"]
    }
  }
}

Claude Code (~/.claude/settings.json)

{
  "mcpServers": {
    "lifeos": {
      "command": "node",
      "args": ["/Users/yourname/lifeos-mcp/bin/lifeos-mcp.js"]
    }
  }
}

OpenAI Codex (codex.json)

{
  "mcpServers": {
    "lifeos": {
      "command": "node",
      "args": ["/Users/yourname/lifeos-mcp/bin/lifeos-mcp.js"]
    }
  }
}

Ruta personalizada de LifeOS

Pasa --lifeos-path o establece la variable de entorno LIFEOS_PATH:

{
  "mcpServers": {
    "lifeos": {
      "command": "node",
      "args": [
        "/Users/yourname/lifeos-mcp/bin/lifeos-mcp.js",
        "--lifeos-path", "/custom/path/to/lifeos"
      ]
    }
  }
}

Variables de entorno

Variable

Predeterminado

Descripción

LIFEOS_PATH

~/lifeos

Ruta absoluta al directorio raíz de LifeOS

Herramientas

Herramienta

Descripción

lifeos__health

Comprueba el estado del servidor y la disponibilidad de LifeOS

lifeos__get_identity

Lee identity.md — frontmatter + cuerpo

lifeos__get_preferences

Lee preferences.md — frontmatter + cuerpo

lifeos__list_skills

Lista todos los nombres de directorios de habilidades en ~/lifeos/skills/

lifeos__read_skill

Lee la documentación de una habilidad específica

lifeos__list_rules

Lista los nombres de reglas/directrices de ~/lifeos/system/

lifeos__read_rule

Lee un archivo de regla específico

lifeos__list_projects

Lista los nombres de archivo de proyectos de ~/lifeos/projects/

lifeos__read_project

Lee una definición de proyecto específica

lifeos__list_wiki_pages

Lista todas las rutas de páginas wiki de forma recursiva

lifeos__read_wiki_page

Lee una página wiki por ruta

lifeos__search

Búsqueda de texto completo en todos los archivos de LifeOS

lifeos__read_file

Lee cualquier archivo bajo ~/lifeos/ por ruta relativa (seguro contra recorrido de rutas)

lifeos__propose_edge

Propone una arista semántica tipada entre dos nodos de conocimiento

lifeos__accept_edge

Acepta una arista propuesta (requiere consentimiento de escritura)

lifeos__reject_edge

Rechaza una arista propuesta (requiere consentimiento de escritura)

lifeos__read_pending_queue

Lista las propuestas de aristas pendientes (siempre de solo lectura)

Recursos

URI

Descripción

lifeos://identity

Perfil de identidad de LifeOS (identity.md)

lifeos://preferences

Preferencias del usuario (preferences.md)

lifeos://skills/{name}

Documentación de habilidad para ~/lifeos/skills/{name}/

lifeos://projects/{name}

Definición de proyecto para ~/lifeos/projects/{name}.md

lifeos://wiki/{+path}

Página wiki en ~/lifeos/wiki/pages/{path}.md

lifeos://rules/{name}

Regla del sistema en ~/lifeos/system/{name}.md

Todos los recursos de plantilla admiten listado: los clientes pueden enumerar los recursos disponibles.

Subcomandos CLI

# List all rituals with id, title, and trigger summary
lifeos-mcp list

# Validate a ritual spec (structural check)
lifeos-mcp validate ~/lifeos/cadence/rituals/morning-review.md

# Render a ritual to a harness
lifeos-mcp render ~/lifeos/cadence/rituals/morning-review.md --to openclaw
lifeos-mcp render ~/lifeos/cadence/rituals/morning-review.md --to claude-code

Interfaz de renderizado (enchufable)

Los renderizadores de terceros se conectan en tiempo de ejecución mediante registerRenderer:

import { registerRenderer } from "lifeos-mcp/dist/renderers/index.js";

registerRenderer({
  name: "my-harness",
  async render(spec, body, ctx) {
    return {
      files: [{ path: "/out/job.json", content: JSON.stringify(spec) }],
      summary: `Rendered ${spec.id} to my-harness`,
    };
  },
});

Renderizadores integrados: openclaw (JSON de trabajo cron), claude-code (comando slash + launchd plist).

Seguridad

  • Todas las rutas de archivo se validan para permanecer dentro de la raíz de LifeOS: no es posible el recorrido de rutas.

  • El servidor es de solo lectura de forma predeterminada; las herramientas de escritura (lifeos__propose_edge, lifeos__accept_edge, lifeos__reject_edge) requieren consentimiento explícito a través de ~/Library/Application Support/LifeOS/mcp-write-config.json.

  • Solo son accesibles los archivos bajo ~/lifeos/ (o LIFEOS_PATH).

Construcción

cd ~/lifeos-mcp
npm install
npm run build
# Output: dist/ + bin/lifeos-mcp.js

Licencia

MIT

Install Server
F
license - not found
A
quality
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bwats/lifeos-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server