Historic Data MCP

MCP服务器历史价格

MCP服务器使用Groq提供的URL建议和页面抓取来查找用户指定产品或类别的历史价格趋势，然后返回结构化的时间序列和简洁的趋势摘要。

该项目遵循标准的MCP服务器结构。

特性

• 通过Groq聊天完成的URL发现（与OpenAI兼容的API）
• 可选页面抓取以提取价格和日期提及
• 从代码片段和HTML中启发式解析价格和日期
• 聚合为重复数据消除的时间序列和趋势摘要

工具

• 价格_趋势_研究

- 输入： - query （string，必填）：产品/类别查询（例如“Shawn Mendes演唱会门票”） - maxResults （数字，可选，默认值为20）：要检查的最大web结果（内部有上限） - 输出：JSON series （日期/价格点）， summary （方向、变化、货币），以及 sources.

• scrape_price_from_url

- 输入： - url （字符串，必填）：用于抓取价格提及和日期的URL - 输出：JSON，可提取任何内容 series 和 meta.

配置

Groq API密钥

1. 获取Groq API密钥并将其设置为 GROQ_API_KEY （参见env示例）。
2. 可选：设置 GROQ_MODEL （默认值： llama-3.1-8b-instant，自动回退到 openai/gpt-oss-20b)以及 USER_AGENT.

创建本地 .env （或导出环境变量）基于 env.example.

NPX（克劳德桌面/VS代码）

将此添加到您的配置中：

{
  "mcpServers": {
    "historic-price": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-historic-price"],
      "env": {
        "GROQ_API_KEY": "YOUR_API_KEY_HERE",
        "GROQ_MODEL": "llama-3.1-8b-instant"
      }
    }
  }
}

码头工人

构建并运行：

docker build -t mcp/historic-price:latest .
docker run -i --rm \
  -e GROQ_API_KEY="$GROQ_API_KEY" \
  -e GROQ_MODEL="llama-3.1-8b-instant" \
  mcp/historic-price:latest

配置您的客户端以运行如上所示的容器命令。

发展

pnpm i # or npm i / bun i
pnpm dev
pnpm build && pnpm start

许可证

麻省理工学院

参考

此实现使用Groq辅助的URL发现和抓取来生成价格历史序列。