AI导哈

Oracle CLI工具

Oracle是一个MCP服务器/CLI工具，提供本地构建和简易安装的脚本支持。

  • by mazdak
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 mazdak/oracle

使用说明

甲骨文

此存储库构建 oracle MCP服务器/CLI，并为本地构建和轻松安装提供帮助脚本。

易于开发人员安装

./scripts/install.sh

如果您更喜欢自定义位置，请设置 ORACLE_INSTALL_DIR 在运行脚本之前：

ORACLE_INSTALL_DIR="$HOME/.local/oracle-bin" ./scripts/install.sh

脚本编译 oracle，副本 target/release/oracle 进入安装目录，并打印可以添加到shell init中的export命令(~/.zshrc, ~/.bashrc等等），因此未来的shell会拾取二进制文件。

从GitHub版本安装

通过流式传输支持发布的安装程序脚本并让其删除，从GitHub发布页面下载最新的预构建二进制文件 oracle 可执行到 ~/.local/bin （或您的自定义安装目录）：

curl -sSL https://raw.githubusercontent.com/mazdak/oracle/refs/heads/master/scripts/install_release.sh | bash

发布安装程序：

  • 检测 uname -s / uname -m 选择正确的目标三元组(x86_64-apple-darwin, aarch64-apple-darwin, x86_64-unknown-linux-gnu, aarch64-unknown-linux-gnu).
  • 点击GitHub发布的API mazdak/oracle，查找其名称包含该三元组的资产，并下载它。
  • 提取存档（支持 .tar.gz, .tgz, .zip，或原始二进制文件）并安装 oracle 进入 ORACLE_INSTALL_DIR （默认为 ~/.local/bin).
  • 提醒您将安装目录添加到 PATH 如果尚未列出。

您可以通过提前设置这些环境变量来自定义行为：

变量 描述
GITHUB_OWNER 拥有仓库的GitHub帐户或组织（默认值： mazdak).
GITHUB_REPO 存储库名称（默认值： oracle).
ORACLE_RELEASE_TAG 释放标签以供下载，而不是 latest.
ORACLE_TARGET_TRIPLE 如果要强制执行特定的二进制，请覆盖检测到的目标三元组。
ORACLE_ASSET_FILTER 用于匹配发布资产名称的子字符串（默认为目标三元组）。
ORACLE_INSTALL_DIR 最终二进制文件的目录（默认： ~/.local/bin).

例如，要将旧版本安装到自定义目录中：

GITHUB_OWNER=mazdak GITHUB_REPO=oracle ORACLE_RELEASE_TAG=v0.1.0 ORACLE_INSTALL_DIR="$HOME/.local/oracle-bin" \
  curl -sSL https://raw.githubusercontent.com/mazdak/oracle/main/scripts/install_release.sh | bash

发布安装程序需要 curl, python3，或者 tar/unzip （取决于发布资产的打包方式）。

标签自动释放

按下以下标签 vMAJOR.MINOR.PATCH （例如。 git tag v0.5.0 && git push origin v0.5.0)以及 release.yml 工作流将：

  • 运行与CI相同的跨平台构建矩阵（macOS和Linux，x86_64和arm64）(.github/workflows/release.yml#L20).
  • 使用以下命令为该标签创建GitHub Release actions/create-release (.github/workflows/release.yml#L9)
  • 将每个二进制文件打包成 oracle-<tag>-<target>.tar.gz 并将其作为发布资产上传(.github/workflows/release.yml#L42).

工作流设置 permissions: contents: write 因此，它可以发布新的版本；一旦按下标签，就不需要手动释放步骤。

相关 MCP