Gas Agent

🚀 MCP Gas Price Agent Dashboard 🛰️

基于 Node.js、Express 和 TailwindCSS 构建的 MCP 兼容型、面向 AI 的 Gas 价格 Agent。
此仪表板让用户能够监控 Ethereum、BNB 和 Polygon 的实时 Gas 价格，使用自然语言提问，并获取关于何时进行交易的智能建议。

---

🧠 本项目的成果

从最初的目标到完整实现，我们已完成以下内容：

• ✅ 支持 Ethereum、BNB 和 Polygon 的多网络功能
• ✅ 为各个网络提供 实时 Gas 价格 API
• ✅ 提供带交互式图表的 仪表板（随时间变化的 Max Fee 和 Priority Fee）
• ✅ 提供 自然语言处理 Agent，用于理解类似以下的人类提问：
  • “现在是好时机吗？”
  • “最高 Gas 费用是多少？”
  • “比较不同网络”
• ✅ 在 Gas 费用极低时发送 实时提醒
• ✅ 将 Gas 历史记录导出为 CSV
• ✅ 自动刷新的 UI（可调整刷新频率）
• ✅ 使用 Tailwind CSS 构建的 时尚暗色主题 UI
• ✅ 兼容 MCP 的插件（mcp.json），可直接连接到 Claude 或 GPT

---

🔧 功能

Endpoint	描述
/api/gas-price	返回所选网络的实时 Gas 价格
/api/nlp-agent	返回对自然语言问题的智能回复
/dashboard	显示实时 Gas 图表、NLP、导出工具等
/	基于 Tailwind 的首页
mcp.json	面向 AI Agent 的插件架构

---

📸 预览

（展示实时图表、网络选择器、NLP Agent 输入框、CSV 导出功能）

---

📦 技术栈

• Node.js + Express
• TailwindCSS
• Chart.js
• Blocknative, BscScan, PolygonScan APIs
• MCP 插件（适用于 Claude/GPT）

---

🚀 本地运行方法

1. 安装依赖

npm install

2. **Build Tailwind CSS**

```bash
npm run build:css
```

3. **Start server**

```bash
npm start
```

4. **Visit the app**
   Open your browser at:
   [http://localhost:3000](http://localhost:3000)

---

## 🤖 Ask Anything!

The AI Agent supports questions like:

- "Is now a good time?"
- "What’s the gas fee?"
- "What's the average gas price?"
- "What’s the highest gas today?"
- "Which network is cheaper?"
- "Is BNB cheaper than Ethereum?"

---

## 🔌 AI Plugin (MCP)

You can connect this project directly to Claude/GPT via the `mcp.json` file.
Example usage:

```json
{
  "schema_version": "v1",
  "name_for_model": "mcp_gas_agent",
  ...
}
```

---

## 📁 Folder Structure

```
📦 MCP-Gas-Agent
├── public/
│   ├── index.html
│   ├── dashboard.html
│   └── styles.css
├── server.js
├── mcp.json
├── tailwind.config.js
├── package.json
└── README.md
```

---

## 📝 License

MIT © 2025 - MCP Gas Price Agent Team

---