LivebookTools

LivebookTools

Livebook Tools 是一款 CLI 工具，可让你在处理 .livemd 文件时如虎添翼。
其主要功能包括：

• BYOE（自带编辑器） - 将 .livemd 文件同步到已打开的 Livebook 会话，这样你就可以在 Cursor 等 AI 驱动的代码编辑器中编辑这些文件。
• MCP 服务 - 一个简单的模型上下文协议服务，可将 AI 编码 Agent 连接到你的 Livebook 会话。下文将详细介绍。
• 从 CLI 运行 Livebook - 将 .livemd 文件转换为 Elixir 脚本，并像 .exs 脚本一样从上到下运行。如果你想将 Livebook 转为 cron 作业，这会很有用。

安装

Livebook Tools 是一个 Elixir escript。
你可以使用 mix escript.install 命令安装。

mix escript.install github thmsmlr/livebook_tools

安装后，请确保 escript 目录位于你的路径中。

# for normal elixir users
export PATH="$HOME/.mix/escripts:$PATH"

# for asdf elixir users
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 Tools 正常工作，它需要使用分布式 Elixir 连接到正在运行的 Livebook 服务。
具体操作取决于你运行 Livebook 的方式。
最简单的做法是在 ~/.bashrc 或 ~/.zshrc 文件中添加这两个环境变量。

export LIVEBOOK_NODE="[email protected]"
export LIVEBOOK_COOKIE="secret"

之后，无论运行 Livebook Tools 还是 Livebook，这两个程序都会读取这些值，并确保彼此能够连接。 如果你使用 Livebook Desktop 运行，则可能还需要将这些值添加到 ~/.livebookdesktop.sh 文件中。 有关 Livebook Desktop 的更多信息，请查看 Livebook HexDocs。

设置 MCP 服务

MCP 服务是一个简单的模型上下文协议服务，可将 AI 编码 Agent 连接到你的 Livebook 会话。
我亲自使用 Cursor 测试过此实现，不过它应该也适用于任何支持 MCP 协议的 AI 代码编辑器。 MCP 服务通过 STDIO 运行，因此你只需告诉 Cursor 使用该命令进行连接，它便会自动发现工具并将其连接到自己的编码 Agent。 有关 Cursor 如何使用 MCP 的更多信息，请查看 Cursor MCP 文档。

实用技巧

有时你可能想自定义代码的运行方式，无论它是在 Livebook 中运行，还是通过命令行使用 livebook_tools run <file> 运行。 有一些简单的代码片段可用于检测代码是在 Livebook 中运行还是在命令行中运行，

# Detect if we're running in a livebook
is_livebook = !String.ends_with?(__ENV__.file, ".exs")

# If we're running in a livebook, argv doesn't really make sense, so we'll just return an empty list
argv = if is_livebook, do: [], else: System.argv()

# Parse command line arguments
# We'll use OptionParser to handle both flags and positional arguments
{parsed_opts, positional_args, invalid_opts} =
  OptionParser.parse(
    argv,
    strict: [
      dry_run: :boolean,
      limit: :integer
    ],
    aliases: [
      d: :dry_run,
      l: :limit
    ]
  )

# Extract options with default values, in livebook it'll just use the default values
dry_run = Keyword.get(parsed_opts, :dry_run, false)
limit = Keyword.get(parsed_opts, :limit, 10)