Typesense MCP Server

Typesense MCP 服务器

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

演示

特征

资源

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

工具

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

提示

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

安装

通过 npm

通过 mcp-get

发展

安装依赖项：

构建服务器：

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

开发安装

使用 Claude Desktop

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

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

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

调试

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

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

成分

资源

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

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

资源模板

服务器提供以下模板：

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

与 Claude Desktop 一起使用

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

日志记录

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

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

执照

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