使用说明
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):要搜索的数据集的IDsearchType(字符串,可选):“语义”(默认)、“全文”、“混合”或“bm25”filters(对象,可选):高级过滤选项highlightOptions(对象,可选):自定义结果突出显示page(数字,可选):页码,默认1pageSize(数字,可选):每页结果,默认值为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将根据需要使用搜索来过滤和分解查询,并可能根据您的任务进行多个查询。
发展
设置
- 克隆存储库
- 安装依赖项:
npm install
- 复制
.env.dist向.env并配置您的凭据 - 构建项目:
npm run build
脚本
npm run build:构建TypeScript项目npm run watch:观察变化并重建npm run test:运行测试npm run inspector:运行MCP检查器进行调试
许可证
麻省理工学院
