项目简介

Bonsai Search MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器,它通过 Bonsai Search 集群为大型语言模型 (LLMs) 提供强大的搜索功能。借助此服务器,LLM 可以利用 'search' 工具,在其索引数据中执行搜索查询,从而增强 LLM 的上下文感知和信息检索能力。

主要功能点

  • 搜索工具: 提供 'search(query: str)' 工具,允许 LLM 客户端向 Bonsai Search 集群发送搜索请求并获取格式化后的 JSON 结果。

安装步骤

  1. 克隆代码仓库到本地。
  2. 安装所需的 Python 依赖包:
    pip install -r requirements.txt
  3. 在项目根目录下创建 '.env' 文件,并配置 Bonsai 集群的连接信息,包括 'INDEX_NAME' (索引名称) 和 'BONSAI_URL' (集群 URL)。
    INDEX_NAME=your_index_name
    BONSAI_URL=your_bonsai_cluster_url

服务器配置

为了将 Bonsai Search MCP 服务器集成到 MCP 客户端(例如 Claude for Desktop),您需要在客户端的配置文件中添加服务器配置信息。以下是一个 Claude for Desktop 客户端的配置示例,您需要根据实际情况修改 'command' 和 'args' 中的路径:

{
  "mcpServers": {
    "bonsai-mcp": {
      "command": "python",
      "args": [
        "/absolute/path/to/server.py"  // 请替换为 server.py 文件的绝对路径
      ]
    }
  }
}

配置参数说明:

  • 'server name': 服务器名称,这里是 'bonsai-mcp',客户端用此名称标识服务器。
  • 'command': 启动服务器的命令,通常是 Python 解释器 'python'。
  • 'args': 传递给启动命令的参数列表,这里是 'server.py' 脚本的绝对路径。请务必替换 '/absolute/path/to/server.py' 为您本地 'server.py' 文件的实际绝对路径。您可以使用 'pwd' 命令获取当前目录,然后拼接 'server.py' 得到绝对路径。

基本使用方法

  1. 确保已安装 Python 3.10 或更高版本,并已安装项目依赖。
  2. 配置 '.env' 文件,设置 'INDEX_NAME' 和 'BONSAI_URL' 环境变量。
  3. 运行服务器:在终端中执行 'python server.py' 命令启动 MCP 服务器。
  4. 在 MCP 客户端(如 Claude for Desktop)中配置并启用 'bonsai-mcp' 服务器。
  5. 在客户端中,LLM 即可通过调用 'search(query: str)' 工具来使用 Bonsai Search 提供的搜索功能。例如,在 Claude 中,您可以指示 Claude 使用 'search' 工具来检索信息。

信息

分类

网页与API