remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

The MCP server is built on Node.js as indicated by the Node.js version badge and installation requirements.

Typesense MCP 服务器

模型上下文协议 (MCP)服务器实现，为 AI 模型提供访问Typesense搜索功能的权限。该服务器使 LLM 能够发现、搜索和分析存储在 Typesense 集合中的数据。

演示

特征

资源

通过typesense:// URI 列出并访问集合
每个集合都有名称、描述和文档数量
用于架构访问的 JSON MIME 类型

工具

typesense_query
- 使用强大的过滤功能在 Typesense 集合中搜索文档
- 输入：查询文本、集合名称、搜索字段、过滤器、排序选项、限制
- 返回具有相关性分数的匹配文档
typesense_get_document
- 根据 ID 从集合中检索特定文档
- 输入：集合名称、文档ID
- 返回完整的文档数据
typesense_collection_stats
- 获取有关 Typesense 集合的统计信息
- 输入：集合名称
- 返回集合元数据、文档计数和架构信息

提示

分析_集合
- 分析馆藏结构和内容
- 输入：集合名称
- 输出：关于模式、数据类型和统计数据的见解
搜索建议
- 获取针对集合的有效搜索查询建议
- 输入：集合名称
- 输出：基于收集模式的推荐搜索策略

安装

通过 npm

# Global installation
npm install -g typesense-mcp-server

# Local installation
npm install typesense-mcp-server

通过 mcp-get

npx @michaellatman/mcp-get@latest install typesense-mcp-server

发展

安装依赖项：

npm install

构建服务器：

npm run build

对于使用自动重建的开发：

npm run watch

开发安装

使用 Claude Desktop

要与 Claude Desktop 一起使用，请添加服务器配置：

在 MacOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json

在 Windows 上： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "typesense": {
      "command": "node",
      "args": [
        "~/typesense-mcp-server/dist/index.js",
        "--host", "your-typesense-host",
        "--port", "8108",
        "--protocol", "http",
        "--api-key", "your-api-key"
      ]
    },
  }
}

调试

由于 MCP 服务器通过 stdio 进行通信，调试起来可能比较困难。我们推荐使用MCP Inspector ，它以包脚本的形式提供：

npm run inspector

检查器将提供一个 URL 来访问浏览器中的调试工具。

成分

资源

服务器提供有关 Typesense 集合的信息：

集合模式（ typesense://collections/<collection> ）
- 每个集合的 JSON 架构信息
- 包括字段名称和数据类型
- 理解数据结构的示例文档

资源模板

服务器提供以下模板：

typesense_search - 构建 Typesense 搜索查询的模板
typesense_collection - 用于查看 Typesense 集合详细信息的模板

与 Claude Desktop 一起使用

要将此服务器与 Claude Desktop 应用程序一起使用，请将以下配置添加到claude_desktop_config.json的“mcpServers”部分：

{
  "mcpServers": {
    "typesense": {
      "command": "npx",
      "args": [
        "-y",
        "typesense-mcp-server",
        "--host", "your-typesense-host",
        "--port", "8108",
        "--protocol", "http",
        "--api-key", "your-api-key"
      ]
    }
  }
}

日志记录

服务器将信息记录到位于以下位置的文件中：

/tmp/typesense-mcp.log

该日志包含有关服务器操作、请求和发生的任何错误的详细信息。

执照

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

MCP 服务器实现，使 AI 模型能够通过查询文档、检索特定项目和访问集合统计信息的工具来发现、搜索和分析存储在 Typesense 集合中的数据。

Related Resources

Reddit Discussion about this server

Typesense MCP Server