Typesense MCP Server
2025.04.22
1
Python数据库管理搜索引擎数据库
Typesense MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于与 Typesense 搜索引擎进行交互。它提供了一系列工具来管理 Typesense 服务器、集合和文档，以及执行搜索操作。
View on GitHub
Overview
基本能力
产品定位
Typesense MCP Server 是一个用于与 Typesense 搜索引擎交互的 MCP 服务，主要用于数据库管理和搜索操作。
核心功能
- 服务器管理：
- 检查 Typesense 服务器的健康状态。
- 列出所有集合。
- 集合管理：
- 创建、删除、描述和截断集合。
- 导出集合中的文档。
- 文档操作：
- 创建、更新、删除文档。
- 批量索引文档。
- 从 CSV 导入文档。
- 搜索能力：
- 关键字搜索。
- 向量相似性搜索。
适用场景
- 需要快速集成 Typesense 搜索引擎的项目。
- 需要管理 Typesense 集合和文档的开发者。
- 需要执行高效搜索操作的应用程序。
工具列表
- Server Management:
check_typesense_health: 检查 Typesense 服务器的健康状态。list_collections: 列出所有集合。- Collection Management:
describe_collection: 获取集合的架构和元数据。export_collection: 导出集合中的所有文档。create_collection: 创建新集合。delete_collection: 删除集合。truncate_collection: 清空集合中的文档但保留架构。- Document Operations:
create_document: 创建单个文档。upsert_document: 创建或更新单个文档。index_multiple_documents: 批量索引文档。delete_document: 删除单个文档。import_documents_from_csv: 从 CSV 导入文档。- Search Capabilities:
search: 执行关键字搜索。vector_search: 执行向量相似性搜索。
使用教程
使用依赖
- 安装
uv:shell brew install uv
安装教程
- 克隆仓库:
shell git clone [email protected]:avarant/typesense-mcp-server.git ~/typesense-mcp-server - 更新
~/.cursor/mcp.json以在 Cursor 中使用:json { "mcpServers": { "server-name": { "command": "uv", "args": ["--directory", "~/typesense-mcp-server", "run", "mcp", "run", "main.py"], "env": { "TYPESENSE_HOST": "", "TYPESENSE_PORT": "", "TYPESENSE_PROTOCOL": "", "TYPESENSE_API_KEY": "" } } } }
调试方式
安装完成后，可以通过运行 uv 命令来启动服务并进行调试。具体命令如下：
uv --directory ~/typesense-mcp-server run mcp run main.py