trieve-mcp-server


A Model Context Protocol (MCP) server that provides agentic tools for interacting with the Trieve API. This server enables AI agents to search and interact with Trieve datasets through a standardized interface.

Features

- Search across Trieve datasets using semantic search
- List and access dataset information
- Support for both environment variables and command-line arguments
- Built with TypeScript for type safety and better developer experience

Installation

$3

To install Trieve for Claude Desktop automatically via Smithery:

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

$3


`bash
npm install trieve-mcp-server
`

Configuration

Copy the .env.dist file to .env and fill in your Trieve credentials:

`bash
cp .env.dist .env
`

Required environment variables:
- TRIEVE_API_KEY: Your Trieve API key from dashboard.trieve.ai
- TRIEVE_ORGANIZATION_ID: Your Trieve organization ID from dashboard.trieve.ai

Optional environment variables:
- TRIEVE_DATASET_ID: Specific dataset ID to use (if not provided via CLI)

Command-line arguments (override environment variables):
`bash
trieve-mcp-server --api-key --org-id [--dataset-id ]
`

Usage

$3

`bash
trieve-mcp-server
`

$3

#### search
Search through a specified Trieve dataset.

Parameters:
- query (string): The search query
- datasetId (string): ID of the dataset to search in
- searchType (string, optional): "semantic" (default), "fulltext", "hybrid", or "bm25"
- filters (object, optional): Advanced filtering options
- highlightOptions (object, optional): Customize result highlighting
- page (number, optional): Page number, default 1
- pageSize (number, optional): Results per page, default 10

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

$3

The server exposes Trieve datasets as resources with the following URI format:
- trieve://datasets/{dataset-id}

Usage with Claude Desktop

The Trieve MCP Server supports MCP integration with Claude Desktop. Place the following in your Claude Desktop's claude_desktop_config.json.

`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"
}
}
}
}
`

Note: Instead of environment variables, --api-key, --org-id, and --dataset-id can be used as command-line arguments.

Once Claude Desktop starts, attachments will be available that correspond to the datasets available to the Trieve organization. These can be used to select a dataset. After that, begin chatting with Claude and ask for information about the dataset. Claude will use search as needed in order to filter and break down queries, and may make multiple queries depending on your task.

Development

$3

1. Clone the repository
2. Install dependencies:
`bash
npm install
`
3. Copy .env.dist to .env and configure your credentials
4. Build the project:
`bash
npm run build
`

$3

- npm run build: Build the TypeScript project
- npm run watch: Watch for changes and rebuild
- npm run test: Run tests
- npm run inspector`: Run the MCP inspector for debugging

License

MIT