trieve-mcp-server

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

特性

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

安装

通过Smithery安装

要通过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获取的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 (数字，可选)：每页结果数，默认为1_0

示例：

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

可用资源

服务器以资源形式暴露Trieve数据集，其URI格式如下：

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

与Claude Desktop的使用

Trieve MCP Server支持与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