Livebook工具

Livebook工具是一款命令行工具，旨在让您在处理.livemd文件时拥有超能力。其主要功能包括：

• BYOE（自带编辑器） - 将您的.livemd文件同步到正在运行的Livebook会话中，以便您可以在像Cursor这样的AI增强代码编辑器中进行编辑。
• MCP服务器 - 一个简单的模型上下文协议服务器，用于将AI编码代理连接到您的Livebook会话。更多内容请参考下文。
• 从CLI运行Livebooks - 将您的.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工具正常工作，它需要能够连接到正在运行的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会话。
我 personally测试过与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的功能。

希望这些信息对您有所帮助！ 如果有任何问题，请随时查阅文档或与社区联系。