MCP Typesense Server

🚀 Typesense MCP 服務器

一個基於 Model Context Protocol (MCP) 的服務器實現，為 AI 模型提供訪問 Typesense 搜索功能的能力。此服務器可助力大型語言模型發現、搜索和分析存儲在 Typesense 集合中的數據。

🚀 快速開始

本服務器基於 Model Context Protocol (MCP) 實現，能讓 AI 模型訪問 Typesense 的搜索功能，大型語言模型可藉此對 Typesense 集合中的數據進行發現、搜索和分析。

✨ 主要特性

資源

• 可通過 typesense:// URI 列出和訪問集合。
• 每個集合都有名稱、描述和文檔數量。
• 採用 JSON MIME 類型進行方案訪問。

工具

• typesense_query

  • 可在 Typesense 集合中搜索文檔，具備強大的過濾功能。
  • 輸入：查詢文本、集合名稱、搜索字段、篩選條件、排序選項、限制。
  • 返回匹配的文檔及其相關性評分。

• typesense_get_document

  • 能從集合中按 ID 獲取特定文檔。
  • 輸入：集合名稱、文檔 ID。
  • 返回完整的文檔數據。

• typesense_collection_stats

  • 可獲取 Typesense 集合的統計信息。
  • 輸入：集合名稱。
  • 返回集合元數據、文檔數量和架構信息。

提示語

• analyze_collection

  • 用於分析集合結構和內容。
  • 輸入：集合名稱。
  • 輸出：關於架構、數據類型和統計信息的見解。

• search_suggestions

  • 提供搜索建議。
  • 輸入：搜索詞。
  • 輸出：基於上下文的搜索建議。

📦 安裝指南

通過 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

使用調試工具

• MCP Inspector：用於分析和監控 MCP 服務的交互式工具

  npm run inspect
  

配置指南

適用於 Claude Desktop

將以下內容添加到你的配置文件中：

{
  "typesense-mcp-server": {
    "path": "~/.config/typesense-mcp-server",
    "log_level": "info"
  }
}

日誌記錄

此 MCP 服務器的日誌文件位於 ~/.config/typesense-mcp-server/logs。日誌文件會記錄所有操作、錯誤和其他重要事件，幫助您監控和維護服務器狀態。

📄 許可證

本 MCP 服務器根據 MIT 許可證發佈。這意味著您可以自由使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。有關詳細信息，請參閱項目倉庫中的 LICENSE 文件。