MCP Jpl

🚀 MCP 介紹

此倉庫包含實驗性的 Model Context Protocol (MCP) 服務器，用於與 Algolia API 進行交互。這是一個我們分享給您的項目，供您探索和實驗。您可以隨意使用、復刻（fork）或在此基礎上進行開發。但請注意，它並非由 Algolia 官方支持，也不在我們的服務級別協議（SLA）覆蓋範圍內。我們可能會對其進行更新、修改或完全刪除。如果您自定義或配置了某些內容，有可能會丟失這些工作。此外，在生產環境中使用 MCP 可能會影響您的 Algolia 使用體驗。

如果您有任何反饋、想法（甚至代碼），我們非常樂意傾聽。請明確一點：MCP 並不被視為“API 客戶端”以符合 SLA 目的。

🚀 快速開始

本項目是一個實驗性的 MCP 服務器，用於與 Algolia API 交互。您可以自由探索和開發，但要注意它沒有官方支持。下面為您介紹如何安裝和使用該服務器。

📦 安裝指南

基礎安裝

首先按照 快速入門 指導進行，該指南將安裝 Claude Desktop 並設置一個文件服務器 MCP 服務器。這是一個很好的入門介紹，可幫助您使用官方指南調試問題。

設置原型 Algolia MCP 服務器

需求

• Go（https://go.dev/doc/install）

克隆倉庫並構建服務器

克隆倉庫，並構建 mcp 服務器：

$ git clone git@github.com:algolia/mcp.git
$ cd mcp/cmd/mcp
$ go build

我們需要找到構建好的服務器二進制文件的完整路徑：

$ pwd
/path/to/the/repo/cmd/mcp

⚠️ 重要提示

當將此命令添加到配置時，必須指定二進制文件及其路徑（/path/to/the/repo/cmd/mcp/mcp）。

更新設置以指向新服務器

在 Claude Desktop 中編輯設置，如 此處 所示，並在此時添加 Algolia 服務器定義（使用前面找到的二進制文件路徑）。設置如下：

{
   "mcpServers": {
      "algolia": {
         "command": "/path/to/the/repo/cmd/mcp/mcp",
         "env": {
            "ALGOLIA_APP_ID": "<APP_ID>",
            "ALGOLIA_API_KEY": "<API_KEY>",
            "ALGOLIA_INDEX_NAME": "<INDEX_NAME>"
          }
        }
      }
    }

將 <APP_ID>、<API_KEY> 和 <INDEX_NAME> 替換為您自己的 Algolia 應用 ID、API Key 和索引名稱。

啟動 MCP 服務器

在終端中啟動 MCP 服務器：

$ go run mcp.go

這將啟動一個暴露 /search, /add, /update 和其他相關端點的服務器，您可以使用這些端點與 Algolia 索引交互。

💻 使用示例

調試驗證

要驗證服務器是否正常運行，請嘗試以下命令：

# 搜索操作
curl -X GET "http://localhost:8080/search?q=running"

# 添加文檔
curl -X POST "http://localhost:8080/add" \
  --header 'Content-Type: application/json' \
  --data-raw '{"body":"This is a test document", "title":"Test Document"}'

# 更新文檔
curl -X PUT "http://localhost:8080/update/123" \
  --header 'Content-Type: application/json' \
  --data-raw '{"body":"Updated test document", "title":"Updated Test Document"}'

📚 詳細文檔

常見問題解答

我可以對安裝的 MCP 執行哪些操作？

以下是一些示例提示，以激發您的想象力：

• “搜索品牌為‘Nike’且價格低於 100 的所有產品。”
• “將此 JSON 對象添加到博客文章索引中。”
• “更新食譜索引的可搜索屬性以包含配料。”
• “配置我的索引，使 nebula_award 獲獎者排名更高。”

我可以在何處閱讀更多關於 Algolia MCP 服務器的信息？

查看 這篇博文，其中包括一個嵌入的演示視頻。

資源模板和根當前不被 Claude Desktop 支持

這是一個奇怪的問題，因為有很多在線內容顯示模板，可能只是還沒有正式發佈。