mcpField
T
TypesenseKit

TypesenseKit

Local
github.com/akshitkrnagpalDatabases3Updated 6w ago
Repository

About TypesenseKit

TypesenseKit is an open-source MCP server for Typesense, giving AI agents structured operation tools with read-only access by default. Its coverage includes search, schema inspection, collection operations, and cluster administration.

Key features

  1. 01Typed operations for Typesense
  2. 02Search and schema inspection
  3. 03Collection operations
  4. 04Cluster administration
  5. 05Read-only by default, with configurable write access

Use cases

  1. 01Let an AI agent query Typesense data
  2. 02Inspect collection schemas and configuration
  3. 03Enable write or administrative operations when needed

MCP support

The server exposes Typesense operations as MCP tools for AI agents. Write, delete, and admin tools are disabled by default and can be exposed by setting TYPESENSEKIT_READ_ONLY=false.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "akshitkrnagpal-typesensekit": {
      "command": "npx",
      "args": [
        "-y",
        "@typesensekit/mcp"
      ],
      "env": {
        "TYPESENSE_URL": "<TYPESENSE_URL>",
        "TYPESENSE_API_KEY": "<TYPESENSE_API_KEY>",
        "TYPESENSEKIT_READ_ONLY": "<TYPESENSEKIT_READ_ONLY>",
        "TYPESENSE_CONNECTION_TIMEOUT_SECONDS": "<TYPESENSE_CONNECTION_TIMEOUT_SECONDS>"
      }
    }
  }
}
Run commandnpx -y @typesensekit/mcp
Environment variables to set
TYPESENSE_URLURL of the Typesense server, including protocol and port when required.
TYPESENSE_API_KEYSecretTypesense API key used to authenticate server operations.
TYPESENSEKIT_READ_ONLYExpose only read operations unless explicitly disabled.
TYPESENSE_CONNECTION_TIMEOUT_SECONDSOptional Typesense connection timeout in seconds.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@typesensekit/mcp1.4.3

Tools

45

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

@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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.