🤖 异步表扬与责备 MCP 服务器

AsyncPraiseRebuke-MCP 是一个 模型上下文协议（MCP） 服务器，提供业务反馈和联系发现工具——包括基于 AI 代理的流程——以供与 Claude Desktop 或任何其他符合 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 的端点调用  
  main.ts            // MCP 工具定义  
  types.ts           // 共享类型  
  scanAndLogNewBusinessEmails.ts // CLI 代理包装器  

/test
  businessesToScan.json // 测试数据样本  

🧪 测试代理

确保安装依赖项并构建项目：

npm install
npm run build

然后运行：

npx @fabianwilliams/asyncpraiserebuke-mcp scanAndLogNewBusinessEmails

或通过 Claude Desktop 测试：

请扫描以下网站以查找联系邮箱，并记录任何不在目录中的新条目：https://example1.com, https://example2.com

📦 发布

对于维护者：

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

🪪 许可证

MIT — 使用、分叉并代理化。

由 @fabianwilliams 热心打造