Typesense

🚀 類型感知 MCP 服務器

這是一個與 Typesense(https://github.com/modelcontextprotocol/python-sdk)（MCP）協議接口的 MCP 服務器，可助力相關業務高效運行。

🚀 快速開始

📦 安裝指南

1. 安裝 uv，在 Mac 上可以使用 homebrew 進行安裝，命令如下：

brew install uv

2. 克隆包：

git clone git@github.com:avarant/typesense-mcp-server.git ~/typesense-mcp-server

3. 更新你的 .cursor/mcp.json 以在 Cursor 中使用：

{
  "mcpServers": {
    "typesense": {
      "command": "uv",
      "args": ["--directory", "~/typesense-mcp-server", "run", "mcp", "run", "main.py"],
      "env": {
        "TYPESENSE_HOST": "",
        "TYPESENSE_PORT": "", 
        "TYPESENSE_PROTOCOL": "",
        "TYPESENSE_API_KEY": ""
      }
    }
  }
}

✨ 主要特性

Typesense MCP Server 提供了豐富的工具，涵蓋服務器管理、集合管理、文檔操作和搜索功能等多個方面，具體如下：

服務器管理

• check_typesense_health - 檢查配置的 Typesense 服務器的健康狀態
• list_collections - 獲取 Typesense 服務器中所有集合的列表

集合管理

• describe_collection - 獲取特定集合的架構和元數據
• export_collection - 導出特定集合中的所有文檔
• create_collection - 使用提供的架構創建新集合
• delete_collection - 刪除特定集合
• truncate_collection - 通過刪除所有文檔但保留架構來截斷集合

文檔操作

• create_document - 在特定集合中創建單個新文檔
• upsert_document - 上插入（創建或更新）特定集合中的單個文檔
• index_multiple_documents - 批量插入（創建、上插入或更新）多個文檔
• delete_document - 根據其 ID 從特定集合中刪除單個文檔
• import_documents_from_csv - 從 CSV 數據導入文檔到集合

搜索功能

• search - 在特定集合上執行關鍵字搜索
• vector_search - 在特定集合上執行向量相似性搜索