Percolate

Percolate MCP サーバー

Claude、またはMCP互換のAIクライアントからPercolateのスペシャルティコーヒーデータベースを検索できます。テイスティングプロファイル、抽出レシピ、ペアリング、購入先へのリンクを含む、厳選された1,100種類以上のコーヒーに読み取り専用でアクセスできます。

PercolateはiOS向けのスペシャルティコーヒージャーナルです — App Storeから入手。

ツール

ツール	機能
search_coffees	カテゴリ、焙煎度、抽出方法、価格で絞り込めるカタログ検索
get_coffee	1種類のコーヒーの詳細情報：焙煎、ボディ／酸味／甘み、風味、ペアリング、販売店
find_similar	風味の重なりや焙煎度／ボディ／酸味の近さから、類似するコーヒーを検索
get_recommendations	風味の好み、予算、焙煎度、使用する抽出器具に基づくおすすめ
compare_coffees	プロファイル、共通／異なる風味、価格差を並べて比較
trending_coffees	Percolateユーザーが現在コレクションに追加しているコーヒー
dial_in_suggestion	特定のコーヒーの抽出ガイダンス — カタログ内の厳選レシピ（比率、温度、挽き目）、または焙煎度に基づく開始点
what_to_brew	今飲むのにぴったりのコーヒー — 夜はデカフェ、朝は明るい風味のものを優先

すべての応答には、出典の表示、引用に使える要約文、リンク、データの更新日が含まれます。スコアリングはすべて決定論的であり、サーバー内部でAIの呼び出しは行われません。すべてのツールには読み取り専用／冪等の注釈が付いています。

インストール（Claude Desktop）

Node.js 18+が必要です。

claude_desktop_config.jsonに追加します（Claude Desktop → 設定 → 開発者 → 設定を編集）：

{
  "mcpServers": {
    "percolate": {
      "command": "npx",
      "args": ["-y", "percolate-mcp"]
    }
  }
}

Claude Desktopを再起動してください。APIキーも設定も不要です — サーバーには公開の読み取り専用アクセス機能が含まれています。

設定（任意）

環境変数でデフォルト値を上書きできます（明示的に指定した環境変数のみ — このパッケージが.envファイルを読み取ることはありません）：

変数	用途
SUPABASE_URL	データベースURLを上書きします
SUPABASE_SERVICE_ROLE_KEY	内部利用のみ — 直近30日間のコレクション追加に基づくトレンドをリアルタイムで取得できます。このキーを配布しないでください。

サービスキーがない場合、trending_coffeesはカタログの人気度にフォールバックし、応答内でその方式を示します。

リモートエンドポイント（インストール不要）

URLを指定するウェブエージェントやMCPクライアント向けのストリーミング可能なHTTPエンドポイントです：

https://wmpiabzlcaqyrzxvfihi.supabase.co/functions/v1/mcp

Smitheryおよび公式MCPレジストリにもio.github.bguillow-rgb/percolateとして掲載されています。

エージェントへのリクエスト例

これらのツールでエージェントが回答できる質問：

• 「チョコレートやナッツの風味がある中煎りをおすすめして。」 → get_recommendationsにpreferences: ["chocolate","nutty"], roast_level: "medium"を指定
• 「このOnyx MonarchをV60でどう抽出すればいい？」 → dial_in_suggestion（厳選レシピ：比率、温度、挽き目）
• 「20ドル以下でエスプレッソに合うコーヒーは？」 → search_coffeesにbrew_method: "espresso", price_max: 20を指定
• 「今夜は何を淹れよう？」 → what_to_brew（夜は自動的にデカフェを優先）
• 「このエチオピアのナチュラルと似たものを探して。」 → find_similar
• 「この2つのコーヒーを比較して。」 → compare_coffees

応答形式の例（一部省略）：

{
  "method": "curated_pairing",
  "recipes": [
    { "recipe": "Pour-over (V60), 1:16, 205°F",
      "why": "clarity that lets the delicate, high-acid notes open up" }
  ],
  "attribution": {
    "source": "Percolate — Specialty Coffee Journal",
    "links": { "website": "https://percolateapp.com/" }
  }
}

開発

npm install
npm run dev     # run from TypeScript via tsx
npm run build   # compile to dist/
npm start       # run compiled server

サーバーはstdio経由でMCPを使用します。カタログへのアクセスは設計上読み取り専用です。すべてのクエリ経路で、行レベルセキュリティにより一般公開されているテーブルに対してSELECTを実行し、呼び出し回数は毎分60回に制限されています。

利用状況のテレメトリー：各ツールの呼び出しでは、ツール名、引数、クライアント名／バージョン、所要時間、成功／失敗が書き込み専用のログテーブルに記録されます（RLSにより挿入のみ可能。内容は一般公開されず、90日後に削除されます）。ユーザーの身元、アカウントデータ、会話内容は収集されません。ログ記録は応答に影響を与えないよう、非同期で実行されます。

データと出典表記

コーヒーのデータ、テイスティングプロフィール、抽出レシピ、ペアリングは Percolate が厳選しています。小売店へのリンクにはアフィリエイトリンクが含まれる場合があります。出典を明記すれば、自由に引用できます。

出典：Percolate — Specialty Coffee Journal (percolateapp.com)

各コーヒーに記載されている鮮度の日付は、データの最終更新日を示しています。