Typesense MCP Server

基本能力

产品定位

Typesense MCP Server 是一个用于与 Typesense 搜索引擎交互的 MCP 服务，主要用于数据库管理和搜索功能。

核心功能

1. 服务器管理：
2. 检查 Typesense 服务器的健康状态

3. 列出所有集合

4. 集合管理：

5. 描述集合的架构和元数据
6. 导出集合中的所有文档
7. 创建新集合
8. 删除集合

9. 清空集合（保留架构）

10. 文档操作：

11. 创建单个文档
12. 更新或创建单个文档
13. 批量索引多个文档
14. 删除单个文档

15. 从 CSV 导入文档

16. 搜索能力：

17. 关键字搜索
18. 向量相似性搜索

适用场景

• 需要与 Typesense 搜索引擎集成的应用
• 需要管理数据库集合和文档的场景
• 需要高性能搜索功能的场景

工具列表

1. Server Management
2. check_typesense_health: 检查 Typesense 服务器的健康状态

3. list_collections: 列出所有集合

4. Collection Management

5. describe_collection: 获取集合的架构和元数据
6. export_collection: 导出集合中的所有文档
7. create_collection: 创建新集合
8. delete_collection: 删除集合

9. truncate_collection: 清空集合

10. Document Operations

11. create_document: 创建单个文档
12. upsert_document: 更新或创建单个文档
13. index_multiple_documents: 批量索引多个文档
14. delete_document: 删除单个文档

15. import_documents_from_csv: 从 CSV 导入文档

16. Search Capabilities

17. search: 关键字搜索
18. vector_search: 向量相似性搜索

使用教程

使用依赖

1. 安装 uv shell brew install uv

安装教程

1. 克隆仓库 shell git clone [email protected]:avarant/typesense-mcp-server.git ~/typesense-mcp-server

2. 更新 .cursor/mcp.json 以在 Cursor 中使用 json { "mcpServers": { "typesense": { "command": "uv", "args": ["--directory", "~/typesense-mcp-server", "run", "mcp", "run", "main.py"], "env": { "TYPESENSE_HOST": "", "TYPESENSE_PORT": "", "TYPESENSE_PROTOCOL": "", "TYPESENSE_API_KEY": "" } } } }

调试方式

安装完成后，可以通过运行提供的工具命令进行调试，例如：

uv --directory ~/typesense-mcp-server run mcp run main.py check_typesense_health

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。