🤖 AsyncPraiseRebuke MCP Server

🤖 AsyncPraiseRebuke MCP サーバー

AsyncPraiseRebuke-MCP は、Claude Desktop やその他の MCP 準拠クライアントと連携するための、ビジネスのフィードバックおよび連絡先の検索ツール（AI エージェントベースのフローを含む）を提供する Model Context Protocol（MCP） サーバーです。

🔍 できること

このサーバーでは、次のようなツールを利用できます。

• ✅ 顧客のフィードバックレビューを一覧表示・検索する
• ✅ 評価が最も高い施設と最も低い施設を表示する
• ✅ スクレイピングとヒューリスティックを使って、ビジネスの連絡先メールアドレスを検索する
• ✅ Cosmos DB ベースのディレクトリに新しいエントリを記録する
• ✅ ツールのロジックをエージェントで連鎖させ、複数ステップのフローを自動化する

🧩 利用可能なツール

コアツール（ステートレスで再利用可能）

これらは、個別の機能に特化して使用できます。

• `listPublicReviews` – すべての公開フィードバックエントリを取得します
• `getTopRatedLocations` – 評価が最も高いビジネスと最も低いビジネスを表示します
• `searchReviews` – ビジネス名の一部を使ってレビューを検索します
• `searchBusinessDirectory` – Cosmos DB 内の既存のビジネスエントリを検索します
• `logBusinessEmail` – ビジネスの連絡先メールアドレスを手動で追加します
• `discoverBusinessEmail` (ClicknContact 由来) – ビジネスのウェブサイトからメールアドレスとフォームのフィールドを検出します

🧠 エージェントツール：`discoverAndLogBusinessEmail`

このエージェント化されたツールは、ワークフロー全体を自動化します。

1. ClicknContact を呼び出して連絡先情報を検出します
2. 重複を防ぐため、Cosmos DB ディレクトリを確認します
3. 必要に応じて、プレースホルダー値を使って新しいビジネスを記録します

ツール名： `discoverAndLogBusinessEmail`
ソース： `ClicknContactScannerAgent`

---

🚀 はじめに

npm install -g @fabianwilliams/asyncpraiserebuke-mcp

次に、Claude Desktop の設定に追加します。

"ClicknContactScannerAgent": {
  "command": "npx",
  "args": [
    "--yes",
    "@fabianwilliams/asyncpraiserebuke-mcp",
    "scanAndLogNewBusinessEmails"
  ],
  "env": {
    "REVIEW_API_KEY": "your-key-here",
    "REVIEW_API_BASE_URL": "https://your-api.com/api"
  }
}

次のように、手動で実行することもできます。

npx --yes @fabianwilliams/asyncpraiserebuke-mcp scanAndLogNewBusinessEmails

---

🛠 開発構成

/src
  apiClient.ts       // Cosmos-backed endpoint calls
  main.ts            // MCP tool definitions
  types.ts           // Shared types
  scanAndLogNewBusinessEmails.ts // CLI agent wrapper

/test
  businessesToScan.json // Sample test data

---

🧪 エージェントのテスト

依存関係がインストールされていることを確認し、プロジェクトをビルドします。

npm install
npm run build

次に、実行します。

npx @fabianwilliams/asyncpraiserebuke-mcp scanAndLogNewBusinessEmails

または、Claude Desktop からテストします。

次のウェブサイトをスキャンして連絡先メールアドレスを探し、ディレクトリにまだ登録されていないものを記録してください：https://example1.com, https://example2.com

---

📦 公開

メンテナー向け：

npm version patch  # or minor / major
npm publish --access public

---

🪪 ライセンス

MIT — 使用、フォーク、エージェント化はご自由にどうぞ。

❤️ を込めて、@fabianwilliams が作成