log-reflect-mcp

log-reflect-mcp は、個人用記録システムのためのローカルファーストの MCP サーバーです。AI クライアントに、Markdown レコードの保存と取得のための小さく明確なインターフェースを提供し、レコード自体は別のリポジトリに保持します。

これは log-reflect-practice で使用されるディレクトリ規約に合わせて設計されています:

daily/
├── journal/{YYYY}/{YYYYMM}/
└── inputs/{YYYY}/{YYYYMM}/
practices/

現在のスコープ

最初のバージョンでは、意図的に4つのツールのみを公開しています:

• capture_journal: 個人のジャーナル断片を作成または追記します。

• capture_input: 外部入力を Markdown ノートとして保存します。

• get_records_by_date_range: レビューのためにジャーナルと入力レコードを取得します。

• search_records: レコードの内容を検索します。

MCP サーバーはアクセスとストレージを処理します。判断は Agent Skills の責任のままです: ジャーナルをどの程度軽く編集するか、何が入力ノートに属するか、7日間をどのようにレビューするか、繰り返し現れるテーマがいつ Practice になる準備ができたか。

Related MCP server: ai-journal

安全境界

• ソースリポジトリには個人レコードや認証情報は含まれません。

• サーバーは daily/journal/ と daily/inputs/ のみを読み取ることができます。

• 新しいレコードはこれら2つのディレクトリ内にのみ書き込まれます。

• 既存の入力ファイルが黙って上書きされることはありません。

• 日付に対して複数のジャーナルファイルが存在する場合、推測せずに書き込みを停止します。

セットアップ

要件: Node.js 22 以降。

npm install
cp .env.example .env

レコードリポジトリへの絶対パスを設定します:

RECORDS_REPO_PATH=/absolute/path/to/log-reflect-practice

stdio サーバーをビルドして起動します:

npm run build
RECORDS_REPO_PATH=/absolute/path/to/log-reflect-practice npm start

クライアント設定の例

ビルド後、MCP クライアントをコンパイル済みサーバーに向けます:

{
  "mcpServers": {
    "log-reflect": {
      "command": "node",
      "args": ["/absolute/path/to/log-reflect-mcp/dist/src/server.js"],
      "env": {
        "RECORDS_REPO_PATH": "/absolute/path/to/log-reflect-practice",
        "RECORDS_TIME_ZONE": "America/Los_Angeles"
      }
    }
  }
}

開発

npm run check
npm test

ツールを対話的に検査するには:

npx @modelcontextprotocol/inspector node dist/src/server.js

ロードマップ

• 個々のレコードを読み取るための MCP リソースを追加します。

• 判断をストレージコードに移さずに、レビューと Practice 開発のプロンプトを追加します。

• オプトインの Git コミットワークフローを追加します。

• GitHub ベースのストレージアダプターを追加します。

• ローカルワークフローが安定した後にのみ、Streamable HTTP と OAuth を追加します。