LifeOS MCP

Claude Desktop, Claude Code, Cursor, ChatGPT, Codex 또는 모든 MCP 호환 클라이언트 등 어떤 AI 에이전트에게든 귀하의 LifeOS 지식 베이스에 대한 읽기 권한을 부여하세요.

이 서버는 ~/lifeos/에서 읽어오며 lifeos:// 리소스 URI와 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 호환 AI 클라이언트에 다음 항목에 대한 직접적인 읽기 권한을 제공합니다:

표면	~/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`	stdio에서 MCP 서버 시작 (기본값)
`lifeos-mcp --stdio`	stdio에서 MCP 서버 시작 (명시적)
`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` 읽기 — 프런트매터 + 본문
`lifeos__get_preferences`	`preferences.md` 읽기 — 프런트매터 + 본문
`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 (cron 작업 JSON), 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`)