https://github.com/sourabh-khot65/typesense-mcp-server
MCP server for connecting to you typesense collections and retrieve data using your favorite MCP client (Claude/ Cursor)
https://github.com/sourabh-khot65/typesense-mcp-server
Last synced: about 1 month ago
JSON representation
MCP server for connecting to you typesense collections and retrieve data using your favorite MCP client (Claude/ Cursor)
- Host: GitHub
- URL: https://github.com/sourabh-khot65/typesense-mcp-server
- Owner: sourabh-khot65
- Created: 2025-04-02T18:14:36.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-04-28T06:19:13.000Z (7 months ago)
- Last Synced: 2025-05-21T22:11:36.981Z (6 months ago)
- Language: Go
- Size: 32.2 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **typesense-mcp-server** - MCP server for Typesense `go` `mcp` `server` `python` `mcp-server` `go install sourabh-khot65/typesense-mcp-server@latest` (⚙️ DevOps)
- toolsdk-mcp-registry - ❌ typesense-candidate-search
README
# Typesense MCP Server
A Model Control Protocol (MCP) server for interacting with Typesense, a fast, typo-tolerant search engine. This server provides a standardized interface for performing searches across any Typesense collection.
## Features
- Generic search interface for any Typesense collection
- Support for all Typesense search parameters
- Typo-tolerant search
- Filtering and faceting support
- Pagination
## Configuration
The server can be configured using the following environment variables:
- `TYPESENSE_HOST`: Typesense server host (default: "localhost")
- `TYPESENSE_PORT`: Typesense server port (default: 8108)
- `TYPESENSE_PROTOCOL`: Protocol to use (http/https) (default: "http")
- `TYPESENSE_API_KEY`: Typesense API key (default: "xyz")
## Available Tools
### typesense_search
Search documents in any Typesense collection.
Parameters:
- `collection` (required): Name of the Typesense collection to search in
- `q` (required): Search query to find documents
- `query_by` (optional): Comma-separated list of fields to search in (default: "*")
- `filter_by` (optional): Filter expressions (e.g., "field:value", "num_field:>100")
- `page` (required): Page number for pagination (1-based)
- `per_page` (required): Number of results per page (default: 10, max: 100)
## Development
### Prerequisites
- Go 1.23 or later
- Access to a Typesense server
### Building
```bash
go build -o typesense-mcp-server
```
### Running
```bash
./typesense-mcp-server
```