MCP Jpl

🚀 MCP 紹介

このリポジトリには、Model Context Protocol (MCP) の実験的なサーバーが含まれており、Algolia API とのやり取りに使用されます。これは私たちが皆さんに提供するプロジェクトで、探索や実験のためにご利用いただけます。自由に使用、フォーク、または拡張してください。ただし、このプロジェクトは Algolia 公式によるサポート対象ではなく、SLA の範囲外です。更新、破棄、または完全に削除する可能性があります。カスタマイズや設定を行った場合、その作業が失われる可能性もあります。また、本番環境で MCP を使用すると、Algolia の利用体験に影響を与える可能性があります。

もしフィードバック、アイデア（コードも含む！）があれば、喜んでお聞かせいただきます。明確に言うと、MCP は SLA の目的では「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 キー、インデックス名に置き換えてください。

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 ではサポートされていません

これは奇妙な問題です。多くのオンラインコンテンツにテンプレートが表示されていますが、正式にリリースされていない可能性があります。