Typesense MCP Server
2025.03.28
0
TypeScript搜索服务AI 集成数据访问搜索工具开发效率
Typesense MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，为 AI 模型提供对 Typesense 搜索功能的访问。该服务器使大型语言模型（LLMs）能够发现、搜索和分析存储在 Typesense 集合中的数据。
View on GitHub
Overview
基本能力
产品定位
Typesense MCP Server 是一个连接 AI 模型和 Typesense 搜索服务的中间件，旨在为 AI 模型提供高效的数据搜索和分析能力。
核心功能
- 资源访问
- 通过
typesense://URI 列出和访问集合 - 每个集合包含名称、描述和文档数量
-
提供 JSON 类型的模式访问
-
工具集
- typesense_query: 在 Typesense 集合中搜索文档，支持强大的过滤功能
- typesense_get_document: 通过 ID 从集合中检索特定文档
-
typesense_collection_stats: 获取 Typesense 集合的统计信息
-
提示功能
- analyze_collection: 分析集合结构和内容
- search_suggestions: 获取针对集合的有效搜索查询建议
适用场景
- AI 模型需要访问和搜索结构化数据
- 开发需要集成 Typesense 搜索功能的 AI 应用
- 数据分析师需要通过 AI 模型分析 Typesense 中的数据
工具列表
- typesense_query: 在集合中搜索文档，支持多种搜索参数
- typesense_get_document: 按 ID 获取特定文档
- typesense_collection_stats: 获取集合元数据和统计信息
常见问题解答
- 调试困难：建议使用 MCP Inspector 进行调试
- 日志位置：服务器日志存储在
/tmp/typesense-mcp.log - 许可证：MIT 许可证，允许自由使用、修改和分发
使用教程
使用依赖
- 确保已安装 Node.js
- 确保已安装 Typesense 服务并配置好 API 密钥
安装教程
- 通过 npm 安装
# 全局安装
npm install -g typesense-mcp-server
# 本地安装
npm install typesense-mcp-server
- 通过 mcp-get 安装
npx @michaellatman/mcp-get@latest install typesense-mcp-server
开发安装
npm install
npm run build
# 开发模式（自动重建）
npm run watch
调试方式
- 使用 MCP Inspector 进行调试
npm run inspector
- 检查日志文件
/tmp/typesense-mcp.log