asyncpraiserebuke-mcp

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

AsyncPraiseRebuke-MCP 是一个 模型上下文协议（MCP） 服务器，它提供业务反馈和联系发现工具，其中包括基于 AI 代理的流程，可用于与 Claude Desktop 或任何其他符合 MCP 标准的客户端集成。

🚀 快速开始

安装

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

✨ 主要特性

此服务器为以下功能提供支持：

• ✅ 列出并搜索客户反馈评论
• ✅ 查看评分最高和最低的商家
• ✅ 使用抓取和启发式方法发现业务联系邮箱
• ✅ 将新条目记录到基于 Cosmos DB 的目录中
• ✅ 链接工具逻辑以实现自动化多步骤流程

🧩 可用工具

核心工具（无状态且可重用）

这些工具可以单独使用，以实现特定功能：

• listPublicReviews – 获取所有公开反馈条目
• getTopRatedLocations – 查看评分最高的商家和最低的商家
• searchReviews – 按部分业务名称搜索评论
• searchBusinessDirectory – 在 Cosmos DB 中查找现有业务条目
• logBusinessEmail – 手动添加业务联系邮箱
• discoverBusinessEmail (来自 ClicknContact) – 从商家网站抓取邮件地址和表单字段

🧠 代理工具：discoverAndLogBusinessEmail

此代理化工具自动执行整个工作流：

1. 调用 ClicknContact 来发现联系信息
2. 检查你的 Cosmos DB 目录以防止重复
3. 记录新商家，必要时使用占位符值

工具名称：discoverAndLogBusinessEmail
来源：ClicknContactScannerAgent

🛠 技术细节

开发结构

/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 热心打造