基本能力
产品定位
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 安装
```bash
全局安装
npm install -g typesense-mcp-server
本地安装
npm install typesense-mcp-server
```
- 通过 mcp-get 安装
bash
npx @michaellatman/mcp-get@latest install typesense-mcp-server
开发安装
```bash
npm install
npm run build
开发模式(自动重建)
npm run watch
```
调试方式
- 使用 MCP Inspector 进行调试
bash
npm run inspector - 检查日志文件
/tmp/typesense-mcp.log