Jrnl MCP

🚀 jrnl MCP Server

このModel Context Protocol (MCP)サーバーは、jrnl（コマンドラインのジャーナル）エントリへの読み取り専用アクセスを提供します。

🚀 クイックスタート

このサーバーを使用する前に、いくつかの前提条件を満たす必要があります。また、インストールと設定の手順もあります。以下に詳細を説明します。

✨ 主な機能

• コマンドラインのジャーナルエントリへの読み取り専用アクセスを提供
• 複数のツールを使用してジャーナルエントリを検索、分析できる

📦 インストール

前提条件

• Node.js 18以上
• jrnlをインストールし、設定する (pip install jrnl)

インストール手順

npm install
npm run build
npm link  # jrnl-mcpコマンドとしてグローバルにインストール

📚 ドキュメント

Claude Desktopの設定

Claude Desktopの設定ファイルに以下を追加してください。

macOS

場所: ~/Library/Application Support/Claude/claude_desktop_config.json

設定内容

{
  "mcpServers": {
    "jrnl": {
      "command": "jrnl-mcp"
    }
  }
}

注意: npm link でインストールした場合、コマンドはグローバルに利用可能になります。グローバルインストールせずにローカル開発を行う場合は、以下を使用してください。

{
  "mcpServers": {
    "jrnl": {
      "command": "node",
      "args": ["<path-to-project>/dist/index.js"]
    }
  }
}

利用可能なツール

• search_entries - フィルターを使用してジャーナルエントリを検索
• list_tags - 使用回数を含めてすべてのタグをリスト表示
• get_statistics - ジャーナルの統計情報を取得
• analyze_tag_cooccurrence - タグの共起を分析
• list_journals - 利用可能なジャーナルをリスト表示
• set_journal - 別のジャーナルに切り替え

開発

npm run format  # コードを整形
npm run lint    # リンターを実行
npm test        # テストを実行
npm run build   # 本番用にビルド

Claude Desktopでのテスト

1. プロジェクトをビルド: npm run build
2. Claude Desktopの設定を正しいパスで更新
3. Claude Desktopを再起動
4. Claudeにジャーナルエントリを検索するように依頼してテスト

例のプロンプト:

• "Use jrnl to show me my journal entries from last week"
• "Using jrnl, what tags am I using in my journal?"
• "Can you use jrnl to show me statistics about my journal?"
• "Search my journal entries for entries tagged with @work using jrnl"

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。 詳細はこちら