Livebook Tools

🚀 Livebook工具

Livebook工具是一款命令行工具，它能賦予您處理.livemd文件的強大能力。其主要功能有：

• BYOE（自帶編輯器）：將.livemd文件同步到運行中的Livebook會話，方便您在如Cursor這類AI增強代碼編輯器中進行編輯。
• MCP服務器：一個簡易的模型上下文協議服務器，用於連接AI編碼代理和Livebook會話，更多詳情見下文。
• 從CLI運行Livebooks：把.livemd文件轉換為Elixir腳本並按順序運行，就像運行.exs腳本一樣。若想將Livebook變成cron作業，此功能十分實用。

🚀 快速開始

Livebook工具是一款強大的命令行工具，能讓您在處理.livemd文件時如虎添翼。它具備多種實用功能，能滿足不同場景下的需求。接下來，將為您詳細介紹其安裝、運行及相關配置方法。

✨ 主要特性

• BYOE（自帶編輯器） - 將您的.livemd文件同步到正在運行的Livebook會話中，以便您可以在像Cursor這樣的AI增強代碼編輯器中進行編輯。
• MCP服務器 - 一個簡單的模型上下文協議服務器，用於將AI編碼代理連接到您的Livebook會話。
• 從CLI運行Livebooks - 將您的.livemd文件轉換為Elixir腳本，並按順序運行它們，就像運行一個.exs腳本一樣。

📦 安裝指南

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工具正常工作，它需要能夠連接到正在運行的Livebook服務器，使用分佈式Elixir。要實現這一點，具體操作取決於您如何運行Livebook。最簡單的方法是將兩個環境變量添加到您的~/.bashrc或~/.zshrc文件中。

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

然後，當您運行Livebook工具或Livebook時，兩個程序都會讀取這些值並確保它們能夠互相連接。如果您使用的是Livebook桌面版，則可能需要將這些值添加到~/.livebookdesktop.sh文件中。有關更多Livebook桌面版的信息，請參閱Livebook HexDocs。

設置MCP服務器

MCP服務器是一個簡單的模型上下文協議服務器，允許您將AI編碼代理連接到您的Livebook會話。我親自測試過與Cursor的實現，儘管它應該適用於任何支持MCP協議的AI編輯器。以下是配置步驟：

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的功能。

希望這些信息對您有所幫助！ 如果有任何問題，請隨時查閱文檔或與社區聯繫。