Avalogica Consumer Needs MCP

新兴消费者需要MCP

版本： 0.2.0\ 许可证： 麻省理工学院

Avalogica紧急消费者需求MCP服务器为Avalogica的紧急消费者需求代理提供动力。它分析新兴的消费者信号，综合市场趋势，并帮助企业家和企业主根据他们的能力和当前的市场轨迹头脑风暴新的产品创意。

______________________________________________________________________

特性

• 紧急消费者需求分析 通过专用MCP工具。
• 产品创意头脑风暴 根据用户能力量身定制。
• 信号聚合 来自新兴趋势数据源（详细信息随工具的实施而提供）。
• 双传输（STDIO和HTTP） /health 准备检查路线。
• TypeScript-首先构建具有严格类型检查的管道。

______________________________________________________________________

先决条件

• Node.js 18或更高版本
• OpenAI API密钥（如果使用调用OpenAI Responses API的工具）。

______________________________________________________________________

安装

git clone https://github.com/mdwillman/avalogica-consumer-needs-mcp.git
cd avalogica-consumer-needs-mcp
npm install

配置

复制 .env.example 到 .env 并填写任何所需的值。

cp .env.example .env

OPENAI_API_KEY=sk-...
# Additional consumer‑needs data source keys will be added as tools are implemented.
# PORT=3002

______________________________________________________________________

构建与运行

npm run build
npm run start            # starts HTTP transport on port 8080 by default
npm run dev:stdio        # run via STDIO (useful with the MCP Inspector)
npm run dev:shttp        # HTTP transport with live TypeScript reloading

HTTP服务器公开：

• GET /health → 返回一个JSON有效载荷，确认准备就绪。
• POST /mcp /服务器发送事件 /sse 对于MCP客户。

______________________________________________________________________

工具

Avalogica Consumer Needs MCP服务器现在包括四个基于Exa的研究工具，旨在帮助代理识别新出现的需求，揭示微弱的信号，对类似的讨论进行聚类，并获取整页内容以进行深入推理。

🔍 搜索_紧急_信号

在更广泛的网络上搜索不断变化的消费者需求、投诉和机会的早期指标。\ 非常适合广泛的发现和趋势扫描。

示例

{
  "name": "search_emergent_signals",
  "arguments": {
    "query": "remote workers frustrated with current AI meeting assistants",
    "numResults": 8
  }
}

🧩 search_edge_社区

专注于早期采用者和前沿社区，如Reddit、Hacker News、GitHub和利基论坛。\ 非常适合揭示被黑客攻击的工作流程、痛点和“请有人构建这个”的帖子。

示例

{
  "name": "search_edge_communities",
  "arguments": {
    "query": "founders hacking together automation tools for bookkeeping",
    "numResults": 12
  }
}

🔗 查找_相似_页面

给定一个高信号页面，该工具会在整个网络中找到语义相似的页面。\ 可用于模式检测、聚类问题和识别相邻需求。

示例

{
  "name": "find_similar_pages",
  "arguments": {
    "url": "https://news.ycombinator.com/item?id=12345678",
    "numResults": 10
  }
}

📄 fetch_page_内容

获取一个或多个页面的完整清理文本，以便代理可以深入分析它们——摘要、痛点提取、角色洞察等。

示例

{
  "name": "fetch_page_contents",
  "arguments": {
    "url": "https://example.com/emerging-trend-article",
    "includeSubpages": false
  }
}

______________________________________________________________________

随着Avalogica扩展其紧急需求情报和产品创新能力，将添加更多工具。

______________________________________________________________________

开发说明

• 代码库仍然是ESM("type": "module").
• npm run build 将TypeScript编译为 dist/ 并调整CLI可执行位。
• STDIO传输可以用MCP检查器进行测试： npm run build && npm run inspector.

______________________________________________________________________

许可证

麻省理工学院©马歇尔·D·威尔曼