语义搜索服务

一个基于Trieve API的模型上下文协议(MCP)服务器,提供AI代理搜索和交互Trieve数据集的标准接口。

  • by devflowinc
  • Rust
  • 本地部署
  • 2722 星标
  • 更新于
在 GitHub 查看 devflowinc/trieve

使用说明

trieve mcp服务器

一种模型上下文协议(MCP)服务器,提供用于与Trieve API交互的代理工具。该服务器使AI代理能够通过标准化的界面搜索Trieve数据集并与之交互。

特性

  • 使用语义搜索在Trieve数据集中搜索
  • 列出和访问数据集信息
  • 支持环境变量和命令行参数
  • 使用TypeScript构建,实现类型安全和更好的开发人员体验

安装

通过Smithery安装

通过以下方式自动安装Trieve for Claude Desktop 史密瑟里:

npx -y @smithery/cli install trieve-mcp-server --client claude

手动安装

npm install trieve-mcp-server

配置

复制 .env.dist 文件到 .env 并填写您的Trieve凭据:

cp .env.dist .env

所需的环境变量:

  • TRIEVE_API_KEY:dashboard.Trieve.ai中的Trieve API密钥
  • TRIEVE_ORGANIZATION_ID:您在dashboard.Trieve.ai上的组织ID

可选环境变量:

  • TRIEVE_DATASET_ID:要使用的特定数据集ID(如果未通过CLI提供)

命令行参数(覆盖环境变量):

trieve-mcp-server --api-key <your-api-key> --org-id <your-org-id> [--dataset-id <dataset-id>]

用法

启动服务器

trieve-mcp-server

可用工具

搜索

搜索指定的Trieve数据集。

参数:

  • query (string):搜索查询
  • datasetId (string):要搜索的数据集的ID
  • searchType (字符串,可选):“语义”(默认)、“全文”、“混合”或“bm25”
  • filters (对象,可选):高级过滤选项
  • highlightOptions (对象,可选):自定义结果突出显示
  • page (数字,可选):页码,默认1
  • pageSize (数字,可选):每页结果,默认值为10

例子:

{
  "query": "example search query",
  "datasetId": "your-dataset-id",
  "searchType": "semantic",
  "page": 1,
  "pageSize": 10
}

可用资源

服务器以以下URI格式将Trieve数据集作为资源公开:

  • trieve://datasets/{dataset-id}

使用Claude Desktop

Trieve MCP服务器支持MCP与 克劳德桌面。将以下内容放入您的Claude桌面 claude_desktop_config.json.

{
  "mcpServers": {
    "trieve-mcp-server": {
      "command": "npx",
      "args": ["trieve-mcp-server@latest"],
      "env": {
        "TRIEVE_API_KEY": "$TRIEVE_API_KEY",
        "TRIEVE_ORGANIZATION_ID": "$TRIEVE_ORGANIZATION_ID",
        "TRIEVE_DATASET_ID": "$TRIEVE_DATASET_ID"
      }
    }
  }
}

注意:代替环境变量, --api-key, --org-id,以及 --dataset-id 可以用作命令行参数。

一旦Claude Desktop启动,与以下内容相对应的附件将可用 Trieve组织可用的数据集。这些可用于选择数据集。之后,开始与Claude聊天,并询问有关数据集的信息。Claude将根据需要使用搜索来过滤和分解查询,并可能根据您的任务进行多个查询。

发展

设置

  1. 克隆存储库
  2. 安装依赖项:
npm install
  1. 复制 .env.dist 向 .env 并配置您的凭据
  2. 构建项目:
npm run build

脚本

  • npm run build:构建TypeScript项目
  • npm run watch:观察变化并重建
  • npm run test:运行测试
  • npm run inspector:运行MCP检查器进行调试

许可证

麻省理工学院