TypesenseKit

Official

by typesensekit · TypeScript

95 typed Typesense operations for AI agents through an MCP server that is read-only by default.

@typesensekit/mcp — Model Context Protocol (MCP) Server

An open-source MCP server that exposes 95 typed Typesense operations for AI agents, including structured tools for search, schema inspection, collection operations, and cluster administration. The server is read-only by default, and is designed for developers integrating Typesense into MCP-based agent workflows.

🛠️ Key Features

95 typed Typesense operations
Read-only by default
Tools for search, schema inspection, collection operations, and cluster administration

🚀 Use Cases

Enable AI agents to perform structured Typesense searches
Inspect Typesense schema from an MCP client
Perform collection and cluster administration tasks (as supported by the read-only default)

⚡ Developer Benefits

Typed operation surface for TypeScript-focused integration
Uses Model Context Protocol for agent tool access
Provided documentation links for overview, client setup, and security guidance

⚠️ Limitations

Operates read-only by default (write actions are not implied in the provided source)

🔧 Deployment / Configuration

Example usage: TYPESENSE_URL=http://localhost:8108 TYPESENSE_API_KEY=xyz pnpm dlx @typesensekit/mcp

Topics

automationclimcpmodel-context-protocolsearchtypescripttypesense

packages/mcp/README.md1 KBView on GitHub

@typesensekit/mcp

An open-source Typesense MCP server that gives AI agents structured tools for search, schema inspection, collection operations, and cluster administration. It runs in read-only mode by default.

Typesense MCP overview · Client setup · Security guide · GitHub

TYPESENSE_URL=http://localhost:8108 TYPESENSE_API_KEY=xyz pnpm dlx @typesensekit/mcp

Set TYPESENSEKIT_READ_ONLY=false to expose write/delete/admin tools.

Run the stateless Streamable HTTP server:

TYPESENSE_URL=http://localhost:8108 TYPESENSE_API_KEY=xyz pnpm dlx --package @typesensekit/mcp typesensekit-mcp-http

See the API coverage inventory for supported Typesense operations.

Install

Configuration

Environment variables

TYPESENSE_URLrequired

URL of the Typesense server, including protocol and port when required.

TYPESENSE_API_KEYrequiredsecret

Typesense API key used to authenticate server operations.

TYPESENSEKIT_READ_ONLYdefault true

Expose only read operations unless explicitly disabled.

TYPESENSE_CONNECTION_TIMEOUT_SECONDS

Optional Typesense connection timeout in seconds.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "typesensekit": {
      "command": "npx",
      "args": [
        "-y",
        "@typesensekit/mcp@1.4.3"
      ],
      "env": {
        "TYPESENSE_URL": "<YOUR_TYPESENSE_URL>",
        "TYPESENSE_API_KEY": "<YOUR_TYPESENSE_API_KEY>",
        "TYPESENSEKIT_READ_ONLY": "true",
        "TYPESENSE_CONNECTION_TIMEOUT_SECONDS": "<YOUR_TYPESENSE_CONNECTION_TIMEOUT_SECONDS>"
      }
    }
  }
}