Typesense MCP Server

Name: Typesense MCP Server
Author: avarant

@avarant

代码仓库

关于 Typesense MCP Server

MCP server for Typesense

#python #mcp #mcp-server

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

avarant

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Typesense MCP Server?

A Model Context Protocol (MCP) server that provides a standardized interface to interact with Typesense, a fast open-source search engine. It is designed for developers using MCP-compatible clients (like Claude Desktop, Cursor, Zed, VS Code) to perform search operations, manage collections, and handle documents in Typesense through natural language commands.

How to use Typesense MCP Server?

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.

Key features of Typesense MCP Server

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

Use cases of Typesense MCP Server

Build an AI assistant that can search a Typesense-powered product catalog
Manage collection schemas and bulk-import documents from a conversational interface
Enable semantic vector search queries on text or embeddings stored in Typesense
Automate index maintenance tasks (e.g., truncate, export, delete) via MCP clients

FAQ from Typesense MCP Server

How do I install the Typesense MCP Server?

Install uv (e.g., via Homebrew on macOS), clone the GitHub repository, then configure your MCP client to launch the server with uv run main.py and the required environment variables.

What environment variables are required?

You must set TYPESENSE_HOST, TYPESENSE_PORT, TYPESENSE_PROTOCOL, and TYPESENSE_API_KEY. Optional variables include MCP_TRANSPORT, MCP_HOST, MCP_PORT, MCP_STATELESS_HTTP, and MCP_CORS_ORIGINS.

What MCP transports does this server support?

It supports STDIO (default), legacy SSE, and the newer Streamable HTTP transport. STDIO works with desktop clients; Streamable HTTP is recommended for web-based clients.

Can I use this server with a web client?

Yes. Use the Streamable HTTP transport (set MCP_TRANSPORT=streamable-http) and enable CORS with MCP_CORS_ORIGINS. Stateless mode (MCP_STATELESS_HTTP=true) is required for clients that don’t maintain persistent MCP sessions.

Does this server require a running Typesense instance?

Yes. The server communicates with an existing Typesense server. You must provide its host, port, protocol, and API key via environment variables.

其他分类下的更多 MCP 服务器

MCP Go 🚀

mark3labs

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

8.9K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K