Journal MCP

🚀 ジャーナルMCPサーバー

React Router v7のウェブビューアーを備えた、ジャーナルエントリ用のモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

npxを使ったクイックスタート

インストールせずに直接実行できます。

# ウェブビューアーを起動
npx @coji/journal-mcp --viewer

# Claude Desktopとの統合を設定
npx @coji/journal-mcp --setup

# Claude Desktop用のMCPサーバーを起動
npx @coji/journal-mcp

ローカル開発

依存関係をインストールします。

pnpm install

開発

HMRを使用して開発サーバーを起動します。

pnpm dev

ウェブビューアーは http://localhost:5173 で利用できます。

本番用ビルド

本番用のビルドを作成します。

pnpm build

✨ 主な機能

• 📖 MCPサーバー：Claude Desktopとの統合によるジャーナル管理
• 🌐 ウェブビューアー：Reactベースのインターフェースでジャーナルエントリを閲覧
• 🚀 React Routerによるサーバーサイドレンダリング
• ⚡️ 開発用のホットモジュール置換（HMR）
• 🔒 デフォルトでTypeScriptを使用
• 🎉 TailwindCSSによるスタイリング
• 📁 自動整理機能付きのファイルベースのストレージ

💻 使用例

npxを使用する場合（推奨）

# ヘルプを表示
npx @coji/journal-mcp --help

# Claude Desktopとの統合を設定
npx @coji/journal-mcp --setup

# Claude Desktopの設定を検証
npx @coji/journal-mcp --verify-setup

# Claude Desktop用のMCPサーバーを起動
npx @coji/journal-mcp

# ウェブビューアーを起動
npx @coji/journal-mcp --viewer

# カスタムポートの例
npx @coji/journal-mcp --viewer --port 8080

ローカル開発コマンド

ローカルインストール後の開発用コマンドです。

# ヘルプを表示
node dist/index.js --help

# Claude Desktopの設定を行う
node dist/index.js --setup

# MCPサーバーを起動
node dist/index.js

# ウェブビューアーを起動
node dist/index.js --viewer

ウェブビューアーは http://localhost:8765（または指定したポート）で利用できます。

📚 ドキュメント

MCPツール

サーバーはClaude Desktop用に以下のツールを提供します。

1. add_entry - 新しいジャーナルエントリを追加
2. search_entries - 日付範囲、タグ、またはキーワードで検索
3. get_recent_entries - 最新のエントリを取得
4. list_tags - 使用回数付きのすべてのタグをリスト表示
5. get_entry_by_date - 特定の日付のエントリを取得
6. get_daily_summary - ジャーナルの統計情報を取得

ファイルストレージ

ジャーナルエントリは以下の場所に保存されます。

• 保存場所：~/.local/share/journal-mcp/entries/YYYY/MM/YYYY-MM-DD.md
• フォーマット：YAMLフロントマター付きのMarkdown
• 機能：自動タグ抽出、時間ベースの整理

デプロイメント

Dockerデプロイメント

docker build -t journal-mcp .
docker run -p 8765:8765 journal-mcp

手動デプロイメント

pnpm build の出力をデプロイします。

├── package.json
├── pnpm-lock.yaml
├── build/
│   ├── client/    # 静的アセット
│   └── server/    # サーバーサイドコード

React RouterとMCPを使って❤️ で作られました。