TypesenseKit

Official

by typesensekit · TypeScript

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

io.github.typesensekit/typesensekit — Model Context Protocol (MCP) Server

The io.github.typesensekit/typesensekit MCP server exposes 95 typed Typesense operations to AI agents. It is read-only by default and provides structured tools focused on search, schema inspection, collection operations, and cluster administration.

🛠️ Key Features

95 typed Typesense operations exposed via MCP
Read-only mode enabled by default
Tool coverage includes: search, schema inspection, collection operations, cluster administration
Topics: automation, cli, mcp, model-context-protocol, search, typescript, typesense

🚀 Use Cases

Performing structured Typesense search from AI agents
Inspecting Typesense schema to support agent workflows
Managing or administering collections and clusters via typed tools

⚡ Developer Benefits

Typed operations for AI agent tool calls
Developer setup using environment variables (e.g., TYPESENSE_URL, TYPESENSE_API_KEY)
Install/launch via pnpm dlx @typesensekit/mcp

⚠️ Limitations

Operates in read-only mode by default

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.4"
      ],
      "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>"
      }
    }
  }
}