trieve-mcp-server

一个模型上下文协议（MCP）服务器，提供与 Trieve API 交互的代理工具。该服务器使 AI 代理能够通过标准化接口搜索和与 Trieve 数据集进行交互。

功能

• 使用语义搜索在 Trieve 数据集中进行搜索
• 列出并访问数据集信息
• 支持环境变量和命令行参数
• 使用 TypeScript 构建，确保类型安全并提供更好的开发者体验

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 Trieve：

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 的 Trieve 组织 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（字符串）：搜索查询
• datasetId（字符串）：要搜索的数据集的 ID
• searchType（字符串，可选）："semantic"（默认）、"fulltext"、"hybrid" 或 "bm25"
• filters（对象，可选）：高级过滤选项
• highlightOptions（对象，可选）：自定义结果高亮
• page（数字，可选）：页码，默认 1
• pageSize（数字，可选）：每页结果数，默认 10

示例：

{
  "query": "示例搜索查询",
  "datasetId": "your-dataset-id",
  "searchType": "semantic",
  "page": 1,
  "pageSize": 10
}

可用资源

服务器将 Trieve 数据集暴露为资源，URI 格式如下：

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

与 Claude Desktop 一起使用

Trieve MCP 服务器支持与 Claude Desktop 的 MCP 集成。将以下内容放入 Claude Desktop 的 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

3. 将 .env.dist 复制为 .env 并配置您的凭据
4. 构建项目：

npm run build

脚本

• npm run build：构建 TypeScript 项目
• npm run watch：监视更改并重新构建
• npm run test：运行测试
• npm run inspector：运行 MCP 检查器进行调试

许可证

MIT