Typesense MCP Server

by avarant

8 stars

200 downloads

Not rated

GitHub

About

An MCP server for interacting with the Typesense search engine.

Details

Author: avarant
GitHub stars: 8
Downloads: 200
Categories: Search, Database, Other

- Checks Typesense server health and lists all collections
- Creates, describes, exports, deletes, and truncates collections
- Creates, upserts, deletes, and batch-indexes documents
- Imports documents from CSV data into a collection
- Performs keyword search and vector similarity search on collections
- Supports STDIO, legacy SSE, and Streamable HTTP transports

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Typesense MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

From the repository

Install uv, clone the repository to ~/typesense-mcp-server, then add the server to your MCP client’s configuration file (e.g., ~/.cursor/mcp.json or Claude Desktop config). Set the required environment variables (TYPESENSE_HOST, TYPESENSE_PORT, TYPESENSE_PROTOCOL, TYPESENSE_API_KEY). Run the server with the default STDIO transport or switch to HTTP transports for web clients.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "typesense mcp server": {
            "typesense-mcp-server": {
                "command": "uv",
                "args": [
                    "run",
                    "python",
                    "main.py"
                ],
                "env": {
                    "TYPESENSE_API_KEY": "xyz"
                }
            }
        }
    }
}

McpServers

{
    "typesense-mcp-server": {
        "command": "uv",
        "args": [
            "run",
            "python",
            "main.py"
        ],
        "env": {
            "TYPESENSE_API_KEY": "xyz"
        }
    }
}

Typesense MCP Server

A Model Context Protocol (MCP) Server that interfaces with Typesense

Installation

Install uv

On Mac you can install it using homebrew

brew install uv

Clone the package

git clone git@github.com:avarant/typesense-mcp-server.git ~/typesense-mcp-server

Add the server to your MCP client config. Most clients (Cursor at ~/.cursor/mcp.json, Claude Desktop at ~/Library/Application Support/Claude/claude_desktop_config.json, Windsurf, Zed, VS Code, etc.) accept the same mcpServers shape:

{
  "mcpServers": {
    "typesense": {
      "command": "uv",
      "args": ["--directory", "~/typesense-mcp-server", "run", "mcp", "run", "main.py"],
      "env": {
        "TYPESENSE_HOST": "",
        "TYPESENSE_PORT": "",
        "TYPESENSE_PROTOCOL": "",
        "TYPESENSE_API_KEY": ""
      }
    }
  }
}

Refer to your client's MCP documentation for the exact config file location.

Transports

The server supports three MCP transports. STDIO is the default and is what most desktop clients (Claude Desktop, Cursor, etc.) use. For remote clients or web UIs, you can run it as an HTTP server using either the legacy SSE transport or the newer Streamable HTTP transport.

STDIO (default)

TYPESENSE_API_KEY=xyz uv run python main.py

Streamable HTTP (recommended for web clients)

Single endpoint at /mcp. Works with browser-based clients like the llama.cpp web chat. Set MCP_TRANSPORT=streamable-http (or pass --http):

TYPESENSE_API_KEY=xyz \
MCP_TRANSPORT=streamable-http \
MCP_STATELESS_HTTP=true \
MCP_CORS_ORIGINS='' \
uv run python main.py

- Stateless mode (MCP_STATELESS_HTTP=true) is required for clients that don't keep an MCP session across requests.
- CORS must be enabled (MCP_CORS_ORIGINS) for browser clients. Use a specific origin like http://localhost:8080 in production rather than .

SSE (legacy)

Two endpoints, GET /sse for the event stream and POST /messages/ for JSON-RPC. Set MCP_TRANSPORT=sse (or pass --sse):

TYPESENSE_API_KEY=xyz MCP_TRANSPORT=sse uv run python main.py

Configuration

| Env var | Default | Description |
|-----------------------|-------------|----------------------------------------------------------------------|
| MCP_TRANSPORT | stdio | stdio, sse, or streamable-http |
| MCP_HOST | 0.0.0.0 | Bind address for HTTP transports |
| MCP_PORT | 8000 | Bind port for HTTP transports |
| MCP_STATELESS_HTTP | false | Stateless mode for HTTP transports (required for some web clients) |
| MCP_CORS_ORIGINS | _(empty)_ | Comma-separated allowed origins. Empty disables CORS. * = any. |

Available Tools

The Typesense MCP Server provides the following tools:

Server Management

- check_typesense_health - Checks the health status of the configured Typesense server - list_collections - Retrieves a list of all collections in the Typesense server

Collection Management

- describe_collection - Retrieves the schema and metadata for a specific collection - export_collection - Exports all documents from a specific collection - create_collection - Creates a new collection with the provided schema - delete_collection - Deletes a specific collection - truncate_collection - Truncates a collection by deleting all documents but keeping the schema

Document Operations

- create_document - Creates a single new document in a specific collection - upsert_document - Upserts (creates or updates) a single document in a specific collection - index_multiple_documents - Indexes (creates, upserts, or updates) multiple documents in a batch - delete_document - Deletes a single document by its ID from a specific collection - import_documents_from_csv - Imports documents from CSV data into a collection

Search Capabilities

- search - Performs a keyword search on a specific collection - vector_search - Performs a vector similarity search on a specific collection

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Typesense MCP Server

Installation

Transports

STDIO (default)

Streamable HTTP (recommended for web clients)

SSE (legacy)

Configuration

Available Tools

Server Management

Collection Management

Document Operations

Search Capabilities

Install

More like this

Sequential Thinking

Redis

Brave Search

Filesystem

EverArt

Google Drive