使用说明

项目简介

Anyquery 是一个强大的 SQL 查询引擎,它不仅能让您轻松查询各种数据源(如 JSON、CSV、数据库、云服务等),还能作为 Model Context Protocol (MCP) 服务器运行。这意味着您可以利用 Anyquery 为大型语言模型 (LLM) 客户端提供丰富的上下文信息和工具,从而增强 LLM 的智能和实用性。

主要功能点

  • 多数据源查询: 使用 SQL 灵活查询 JSON, CSV, Parquet, SQLite, Airtable, Google Sheets, Notion, MySQL, PostgreSQL 等多种数据源。
  • 插件化扩展: 通过插件集成更多数据源和功能,支持自定义插件开发。
  • MySQL 服务器模式: 可作为 MySQL 服务器运行,允许使用各种 MySQL 客户端连接和查询。
  • MCP 服务器功能: 通过 MCP 协议与 LLM 客户端通信,提供资源访问和工具执行能力,为 LLM 应用提供上下文服务。
  • 工具注册与执行: 允许 LLM 调用插件提供的外部功能,扩展 LLM 的能力边界。
  • 数据资源管理: 方便地托管和管理各种数据资源,并通过 SQL 进行标准化访问。

安装步骤

Anyquery 提供了多种安装方式,选择适合您系统的方法即可:

1. Homebrew (macOS 和 Linux)

brew install julien040/anyquery/anyquery

2. APT (Debian, Ubuntu)

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

3. YUM/DNF (CentOS, Fedora)

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

4. Scoop (Windows)

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

5. Winget (Windows)

winget install JulienCagniart.anyquery

6. Chocolatey (Windows)

choco install anyquery

或者,您也可以从 GitHub Releases 页面下载预编译的二进制文件。

服务器配置 (MCP 客户端)

MCP 客户端需要配置以下信息以连接 Anyquery MCP 服务器:

{
  "serverName": "anyquery-mcp-server",
  "command": "anyquery",
  "args": [
    "mcp"
  ],
  "transport": "stdio"
}

参数注释:

  • 'serverName': MCP 服务器的名称,您可以自定义。
  • 'command': 启动 Anyquery MCP 服务器的命令,即 'anyquery'。
  • 'args': 传递给 'anyquery' 命令的参数,这里使用 'mcp' 子命令启动 MCP 服务器。
  • 'transport': 指定 MCP 客户端与服务器通信的传输协议,'stdio' 表示使用标准输入/输出。

基本使用方法

  1. 启动 MCP 服务器:

    在终端中运行以下命令启动 Anyquery MCP 服务器:

    anyquery mcp

    您可以使用 '--host' 和 '--port' 参数指定服务器监听的地址和端口,或者使用 '--stdio' 参数通过标准输入/输出进行通信。 更多参数可以使用 'anyquery mcp --help' 查看。

  2. 配置 MCP 客户端:

    根据您的 LLM 客户端的 MCP 配置要求,填入上面提供的服务器配置信息。确保客户端能够连接到 Anyquery MCP 服务器。

  3. 在 LLM 中使用工具和访问数据:

    一旦客户端成功连接到 Anyquery MCP 服务器,您就可以在 LLM 中利用 Anyquery 提供的 SQL 查询能力和插件功能,访问各种数据资源并执行工具,实现更强大的上下文交互和功能调用。

    例如,您可以查询 GitHub 仓库信息、Google Sheets 数据、或者调用插件提供的特定 API 功能,并将结果作为上下文提供给 LLM 进行更深入的对话和任务处理。 具体能使用哪些工具和数据取决于您安装和配置的 Anyquery 插件。

信息

分类

数据库与文件