Meilisearch MCP

🚀 Meilisearch MCP 服務器

Meilisearch MCP 服務器是一款基於 Model Context Protocol (MCP) 的工具，它能提供高效且靈活的搜索和索引功能，幫助用戶更便捷地處理數據搜索與索引相關任務。

🚀 快速開始

安裝步驟

環境變量

在運行服務器之前，請確保設置以下環境變量：

• MEILISERVER：指定 Meilisearch 服務的地址，默認為 http://localhost:7200。
• MCP_API_KEY：MCP 接口的認證密鑰。

動態連接配置

支持動態調整連接參數，如代理和 SSL 驗證。通過以下命令查看或修改配置：

# 查看當前配置
curl http://localhost:7200/config

# 修改配置
curl --data '{"tls_skip_verify":true}' http://localhost:7200/config

搜索功能

支持多種搜索模式，包括精確匹配和模糊搜索。例如：

# 精確查詢
curl --user_key your_api_key --get 'http://localhost:7200/indexes/your_index_name/search?q=your_query'

# 模糊查詢
curl --user_key your_api_key --data '{"q":"search term","page":1}' http://localhost:7200/indexes/your_index_name/search

運行服務器

啟動 Meilisearch MCP 服務器：

python -m src.meilisearch_mcp

與 Claude Desktop 集成

在 claude_desktop_config.json 中添加以下內容以集成 MCP 服務器：

{
  "mcp_server": {
    "url": "http://localhost:7200",
    "api_key": "your_api_key"
  }
}

測試工具

使用 Node.js 工具啟動 Inspector：

npx @modelcontextprotocol/inspector python -m src.meilisearch_mcp

✨ 主要特性

連接管理

• get-connection-settings：獲取當前連接設置。
• update-connection-settings：更新連接參數。

索引管理

• create-index：創建新索引。
• delete-index：刪除指定索引。
• list-indexes：查看所有索引。

文檔操作

• add-document：添加文檔。
• get-document：獲取單個文檔。
• update-document：更新文檔。
• delete-document：刪除文檔。

設置管理

• get-settings：獲取索引設置。
• update-settings：更新索引配置。

任務管理

• create-task：創建新任務。
• get-task：獲取任務狀態。
• list-tasks：查看所有任務。
• cancel-task：取消未完成任務。

系統監控

• health-check：檢查服務器健康狀態。
• get-stats：獲取系統統計信息。
• get-version：查看 Meilisearch 版本。

🤝 貢獻指南

1. Fork 項目倉庫。
2. 創建功能分支。
3. 提交代碼更改。
4. 發送 Pull Request。

📄 許可證

本項目遵循 MIT 協議。