Livebook Tools

🚀 Livebookツール

Livebookツールはコマンドラインツールで、.livemdファイルを扱う際に超能力を与えてくれます。主な機能は以下の通りです。

• BYOE（Bring Your Own Editor） - .livemdファイルを実行中のLivebookセッションに同期し、CursorなどのAI強化コードエディタで編集できるようにします。
• MCPサーバー - AIコーディングエージェントをLivebookセッションに接続するためのシンプルなモデルコンテキストプロトコルサーバーです。詳細は以下を参照してください。
• CLIからLivebookを実行 - .livemdファイルをElixirスクリプトに変換し、.exsスクリプトのように順番に実行します。Livebookをcronジョブにする場合に便利です。

🚀 クイックスタート

Livebookツールを使うことで、.livemdファイルの操作が格段に便利になります。以下では、その機能や使い方を詳しく説明します。

✨ 主な機能

• BYOE（自带编辑器） - .livemdファイルを実行中のLivebookセッションに同期し、CursorなどのAI強化コードエディタで編集できます。
• MCPサーバー - AIコーディングエージェントをLivebookセッションに接続するためのシンプルなモデルコンテキストプロトコルサーバーです。
• CLIからLivebookを実行 - .livemdファイルをElixirスクリプトに変換し、.exsスクリプトのように順番に実行できます。Livebookをcronジョブにする場合に便利です。

📦 インストール

LivebookツールはElixir escriptです。インストールするには、mix escript.installコマンドを使用します。

mix escript.install github thmsmlr/livebook_tools

インストールが完了したら、escriptディレクトリがPATHに含まれていることを確認してください。

# 通常のelixirユーザーの場合
export PATH="$HOME/.mix/escripts:$PATH"

# asdfelixirユーザーの場合
for escripts_dir in $(find "${ASDF_DATA_DIR:-$HOME/.asdf}/installs/elixir" -type d -name "escripts" 2>/dev/null); do
  export PATH="$escripts_dir:$PATH"
done

💻 使用例

基本的な使用法

Livebookツールを使用するには、まずLivebookサーバーに接続する必要があります。以下のコマンドを使用して環境変数を設定します。

export LIVEBOOK_NODE="livebook@127.0.0.1"
export LIVEBOOK_COOKIE="secret"

これにより、LivebookツールとLivebookが互いに接続できるようになります。Livebookデスクトップ版を使用している場合は、~/.livebookdesktop.shファイルにこれらの値を追加する必要があります。詳細はLivebook HexDocsを参照してください。

高度な使用法

MCPサーバーを設定することで、AIコーディングエージェントをLivebookセッションに接続できます。以下は設定手順です。

1. 依存関係のインストール：elixirとerlangなどの必要なパッケージがインストールされていることを確認してください。
2. Livebookサーバーの起動：livebook startを実行します。
3. 環境変数の設定：

   export LIVEBOOK_SERVER_URL="http://localhost:4000"
   

4. MCPサーバーの起動：

   # Elixir REPLまたは新しいファイルで
   alias Livebook.Application, as: LBApp
   
   config = %{
     server_url: System.get_env("LIVEBOOK_SERVER_URL") || "http://localhost:4000",
     cookie: System.get_env("LIVEBOOK_COOKIE") || "_livebook_session"
   }
   
   {:ok, _pid} = LBApp.start_mcp_server(config)
   

📚 ドキュメント

実用的なヒント

Livebookツールを使用する際の有用なヒントをいくつか紹介します。

• エディタの設定：IDEで.livemdファイルのサポートを有効にして、最高のコーディング体験を得ましょう。
• デバッグ：問題が発生した場合は、サーバーログを確認するか、iex -S mixを使用して対話型シェルでデバッグします。
• 機能拡張：カスタムプラグインやスクリプトを作成して、Livebookの機能を拡張します。

以上の情報がお役に立てば幸いです。何か質問があれば、ドキュメントを参照するか、コミュニティに相談してください。