LifeOS MCP

Предоставьте любому ИИ-агенту доступ на чтение к вашей базе знаний LifeOS — Claude Desktop, Claude Code, Cursor, ChatGPT, Codex или любому другому MCP-совместимому клиенту.

Сервер считывает данные из ~/lifeos/ и предоставляет их через URI ресурсов lifeos:// и имена инструментов lifeos__*.

Установка

После публикации (скоро)

npx lifeos-mcp

Из исходного кода (сейчас)

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

Глобальная установка из исходного кода

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

Что он предоставляет

lifeos-mcp дает любому MCP-совместимому ИИ-клиенту прямой доступ на чтение к:

Поверхность	Путь в ~/lifeos/	Инструмент
Личность	`identity.md`	`lifeos__get_identity`
Предпочтения	`preferences.md`	`lifeos__get_preferences`
Навыки	`skills/*/`	`lifeos__list_skills`, `lifeos__read_skill`
Проекты	`projects/*.md`	`lifeos__list_projects`, `lifeos__read_project`
Вики	`wiki/pages/*/.md`	`lifeos__list_wiki_pages`, `lifeos__read_wiki_page`
Правила	`system/*.md`	`lifeos__list_rules`, `lifeos__read_rule`
Любой файл	(безопасный путь)	`lifeos__read_file`
Поиск	(полнотекстовый)	`lifeos__search`

Режимы

Вызов	Что происходит
`lifeos-mcp`	Запуск MCP-сервера через stdio (по умолчанию)
`lifeos-mcp --stdio`	Запуск MCP-сервера через stdio (явно)
`lifeos-mcp list`	Список ритуалов в `~/lifeos/cadence/rituals/`
`lifeos-mcp validate <ritual.md>`	Проверка файла спецификации ритуала
`lifeos-mcp render <ritual.md> --to <harness>`	Рендеринг ритуала для целевой среды
`lifeos-mcp --help`	Показать все подкоманды и опции

Настройка MCP-клиентов

Claude Desktop

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

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

Или из исходного кода:

{
  "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"]
    }
  }
}

Пользовательский путь LifeOS

Передайте --lifeos-path или установите переменную окружения LIFEOS_PATH:

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

Переменные окружения

Переменная	По умолчанию	Описание
`LIFEOS_PATH`	`~/lifeos`	Абсолютный путь к корневой директории LifeOS

Инструменты

Инструмент	Описание
`lifeos__health`	Проверка работоспособности сервера и доступности LifeOS
`lifeos__get_identity`	Чтение `identity.md` — frontmatter + тело
`lifeos__get_preferences`	Чтение `preferences.md` — frontmatter + тело
`lifeos__list_skills`	Список всех имен директорий навыков в `~/lifeos/skills/`
`lifeos__read_skill`	Чтение документации для указанного навыка
`lifeos__list_rules`	Список имен правил/рекомендаций из `~/lifeos/system/`
`lifeos__read_rule`	Чтение конкретного файла правила
`lifeos__list_projects`	Список имен файлов проектов из `~/lifeos/projects/`
`lifeos__read_project`	Чтение конкретного определения проекта
`lifeos__list_wiki_pages`	Рекурсивный список всех путей к страницам вики
`lifeos__read_wiki_page`	Чтение страницы вики по пути
`lifeos__search`	Полнотекстовый поиск по всем файлам LifeOS
`lifeos__read_file`	Чтение любого файла в `~/lifeos/` по относительному пути (безопасно от обхода путей)
`lifeos__propose_edge`	Предложить типизированную семантическую связь между двумя узлами знаний
`lifeos__accept_edge`	Принять предложенную связь (требуется явное разрешение на запись)
`lifeos__reject_edge`	Отклонить предложенную связь (требуется явное разрешение на запись)
`lifeos__read_pending_queue`	Список ожидающих предложений связей (всегда только чтение)

Ресурсы

URI	Описание
`lifeos://identity`	Профиль личности LifeOS (`identity.md`)
`lifeos://preferences`	Предпользовательские настройки (`preferences.md`)
`lifeos://skills/{name}`	Документация навыка для `~/lifeos/skills/{name}/`
`lifeos://projects/{name}`	Определение проекта для `~/lifeos/projects/{name}.md`
`lifeos://wiki/{+path}`	Страница вики по адресу `~/lifeos/wiki/pages/{path}.md`
`lifeos://rules/{name}`	Системное правило в `~/lifeos/system/{name}.md`

Все шаблонные ресурсы поддерживают перечисление — клиенты могут перечислять доступные ресурсы.

Подкоманды 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

Интерфейс рендерера (подключаемый)

Сторонние рендереры подключаются во время выполнения через 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`,
    };
  },
});

Встроенные рендереры: openclaw (JSON для cron-задач), claude-code (косая черта + launchd plist).

Безопасность

Все пути к файлам проверяются на нахождение внутри корня LifeOS — обход путей невозможен.
Сервер по умолчанию работает только на чтение; инструменты записи (lifeos__propose_edge, lifeos__accept_edge, lifeos__reject_edge) требуют явного согласия через ~/Library/Application Support/LifeOS/mcp-write-config.json.
Доступны только файлы в ~/lifeos/ (или LIFEOS_PATH).

Сборка

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

Лицензия

MIT

lifeos-mcp

LifeOS MCP

Установка

После публикации (скоро)

Из исходного кода (сейчас)

Глобальная установка из исходного кода

Что он предоставляет

Режимы

Настройка MCP-клиентов

Claude Desktop

Cursor (`settings.json`)

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

OpenAI Codex (`codex.json`)

Пользовательский путь LifeOS

Переменные окружения

Инструменты

Ресурсы

Подкоманды CLI

Интерфейс рендерера (подключаемый)

Безопасность

Сборка

Лицензия

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API

LifeOS MCP

Установка

После публикации (скоро)

Из исходного кода (сейчас)

Глобальная установка из исходного кода

Что он предоставляет

Режимы

Настройка MCP-клиентов

Claude Desktop

Cursor (settings.json)

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

OpenAI Codex (codex.json)

Пользовательский путь LifeOS

Переменные окружения

Инструменты

Ресурсы

Подкоманды CLI

Интерфейс рендерера (подключаемый)

Безопасность

Сборка

Лицензия

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API

Cursor (`settings.json`)

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

OpenAI Codex (`codex.json`)