Anyquery

Anyquery 是一个 SQL 查询引擎，几乎可以在任何数据源上运行 SQL 查询。它支持查询 文件、数据库 和 应用程序（例如 Apple Notes、Notion、Chrome、Todoist 等）。它基于 SQLite 构建，并使用 插件 来扩展其功能。

它还可以连接到 LLM（例如 ChatGPT、Claude、Cursor、TypingMind 等），使这些模型能够访问您的数据。

最后，它还可以充当 MySQL 服务器 的角色，允许您使用自己喜欢的 MySQL 兼容客户端（例如 TablePlus、Metabase 等）执行 SQL 查询。

使用方法

连接 LLM

LLM 可以使用 模型上下文协议 (MCP) 连接到 Anyquery。该协议为支持它的 LLM 提供上下文信息。您可以使用以下命令启动 MCP 服务器：

# 由 LLM 客户端启动
anyquery mcp --stdio
# 使用 HTTP 和 SSE 隧道连接
anyquery mcp --host 127.0.0.1 --port 8070

您也可以连接到支持函数调用的客户端（例如 ChatGPT、TypingMind）。有关更多信息，请参阅文档中的每个 连接指南。

# 复制命令返回的 ID，并将其粘贴到 LLM 客户端中（例如 ChatGPT、TypingMind）
anyquery gpt

运行 SQL 查询

文档 提供了关于如何使用 Anyquery 运行查询的详细说明。 不过，让我们来看一个快速示例。在终端中输入 anyquery 打开 shell 模式。然后，运行以下查询：

您也可以使用 anyquery server 启动 MySQL 服务器，并使用您喜欢的 MySQL 兼容客户端连接到它。

anyquery server &
mysql -u root -h 127.0.0.1 -P 8070

安装

文档 提供了关于如何在您的系统上安装 Anyquery 的详细说明。您可以从 Homebrew、APT、YUM/DNF、Scoop、Winget 和 Chocolatey 安装 Anyquery。您也可以从 发布页面 下载二进制文件。

Homebrew

brew install anyquery

ARCH LINUX (AUR)

# 使用 AUR 助手如 yay 安装
yay -S anyquery-git

# paru
paru -S anyquery-git

APT

echo "deb [trusted=yes] https://apt.julienc.me/ /" | sudo tee /etc/apt/sources.list.d/anyquery.list
sudo apt update
sudo apt install anyquery

YUM/DNF

echo "[anyquery]
name=Anyquery
baseurl=https://yum.julienc.me/
enabled=1
gpgcheck=0" | sudo tee /etc/yum.repos.d/anyquery.repo
sudo dnf install anyquery

Scoop

scoop bucket add anyquery https://github.com/julien040/anyquery-scoop
scoop install anyquery

Winget

winget install JulienCagniart.anyquery

Chocolatey

choco install anyquery

插件

Anyquery 基于插件架构，您可以安装插件来扩展其功能。您可以从 官方注册表 安装插件，也可以创建自己的插件。Anyquery 还可以 加载任何 SQLite 扩展。

许可证

Anyquery 的核心引擎采用 AGPLv3 许可证。RPC 库则采用 MIT 许可证，以便任何人都可以在不同的项目中重用插件。

插件不受 AGPL 许可证约束。每个插件都有自己的许可证，版权归插件作者所有。 更多信息请参阅 LICENSE 文件。

贡献

如果您想为 Anyquery 做贡献，请阅读 贡献指南。目前我只接受小规模的贡献，但非常欢迎任何建议或反馈。

您可以在 架构 文档中对该项目有一个简要的了解。

Anyquery 快速上手指南

Anyquery 是一个基于 SQLite 构建的通用 SQL 查询引擎。它允许你使用 SQL 语句查询各类文件、数据库以及应用程序（如 Apple Notes、Notion、Chrome、Todoist 等）。此外，它还支持通过 MCP 协议连接大语言模型（LLM），或作为 MySQL 服务器运行，以便通过 TablePlus、Metabase 等客户端进行连接。

环境准备

• 操作系统：支持 macOS、Linux (Debian/Ubuntu, Fedora/CentOS, Arch) 和 Windows。
• 前置依赖：通常无需额外依赖，二进制包已包含所需组件。若需连接特定数据源（如某些数据库驱动），请确保本地环境已安装相应基础库。
• 网络要求：首次安装及加载插件时需要访问互联网。

安装步骤

根据你的操作系统选择以下一种方式进行安装：

macOS (推荐 Homebrew)

brew install anyquery

Linux (Debian/Ubuntu - APT)

echo "deb [trusted=yes] https://apt.julienc.me/ /" | sudo tee /etc/apt/sources.list.d/anyquery.list
sudo apt update
sudo apt install anyquery

Linux (Fedora/CentOS - DNF/YUM)

echo "[anyquery]
name=Anyquery
baseurl=https://yum.julienc.me/
enabled=1
gpgcheck=0" | sudo tee /etc/yum.repos.d/anyquery.repo
sudo dnf install anyquery

Linux (Arch Linux - AUR)

# 使用 yay
yay -S anyquery-git

# 或使用 paru
paru -S anyquery-git

Windows (Scoop)

scoop bucket add anyquery https://github.com/julien040/anyquery-scoop
scoop install anyquery

Windows (Winget)

winget install JulienCagniart.anyquery

Windows (Chocolatey)

choco install anyquery

注意：你也可以直接从 GitHub Releases 页面下载二进制文件手动安装。

基本使用

1. 交互式 SQL 查询

在终端输入 anyquery 进入交互模式，即可直接编写 SQL 查询本地文件、已集成的应用或数据库。

anyquery

进入 Shell 后，你可以执行类似以下的查询（具体表名取决于已加载的插件）：

-- 示例：查询当前可用的表
.tables

-- 示例：查询特定数据（需根据实际插件调整表名）
SELECT * FROM my_data_source LIMIT 10;

2. 作为 MySQL 服务器运行

你可以启动 Anyquery 的 MySQL 兼容服务模式，从而使用熟悉的 MySQL 客户端（如 TablePlus, Metabase, DBeaver 等）进行连接。

启动服务：

anyquery server &

使用 MySQL 客户端连接：

mysql -u root -h 127.0.0.1 -P 8070

3. 连接大语言模型 (LLM)

Anyquery 支持通过 Model Context Protocol (MCP) 或直接生成连接 ID 的方式让 LLM（如 ChatGPT, Claude, Cursor 等）访问你的数据。

方式 A：生成连接 ID (适用于支持 Function Calling 的客户端) 运行以下命令获取 ID，并将其粘贴到 LLM 客户端配置中：

anyquery gpt

方式 B：启动 MCP 服务器

# 标准输入输出模式 (由 LLM 客户端启动)
anyquery mcp --stdio

# HTTP/SSE 隧道模式
anyquery mcp --host 127.0.0.1 --port 8070

扩展功能

Anyquery 采用插件架构。你可以访问 官方集成中心 查找并安装更多插件，以支持查询更多类型的应用和数据源，甚至可以直接加载标准的 SQLite 扩展。