Skip to main content
Glama
bwats
by bwats

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

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

すべてのWikiページパスを再帰的に一覧表示

lifeos__read_wiki_page

パスでWikiページを読み取る

lifeos__search

すべてのLifeOSファイルに対する全文検索

lifeos__read_file

相対パスで ~/lifeos/ 下の任意のファイルを読み取る(パストラバーサル対策済み)

lifeos__propose_edge

2つのナレッジノード間の型付きセマンティックエッジを提案

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 のWikiページ

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

Install Server
F
license - not found
A
quality
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

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