pluginmd/haravan-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

21 stars 7 forks 质量 69 趋势 10Apache-2.0

Repository Install

Haravan电商MCP服务器——连接AI助手（Claude、Cursor、Trae）与Haravan门店。70个工具：订单、产品、客户、库存、RFM细分、智能分析。

概览

Haravan E-commerce OpenAPI MCP Server — Kết nối AI 助手 với Haravan stores. MCP（模型上下文协议）服务器 cho phép AI 助手（Claude、Cursor、Trae） tương tác trực tiếp với Haravan API：quản lý sản phẩm， đơn hàng， khách hàng， tồn kho， webhooks và nhiều hơn. ： Server-side pagination + aggregation cho data lớn ： 1：1 mapping với Haravan API cho detail/CRUD Ngoài MCP 服务器（70 个工具），dự án bao gồm（claudeskill/haravan-mcp/） — bộ não phân tích được upload lên claude.ai， dạy Claude cách sử dụng MCP 工具 hiệu quả nhất。（từ 参考文献/见解公式。

概述（AI 翻译）

Haravan E-commerce OpenAPI MCP Server — Kết nối AI 助手 với Haravan stores.

MCP（模型上下文协议）服务器 cho phép AI 助手（Claude、Cursor、Trae） tương tác trực tiếp với Haravan API：quản lý sản phẩm， đơn hàng， khách hàng， tồn kho， webhooks và nhiều hơn.

英文下方。

Bắt đầu nhanh

Sử dụng với 克劳德 / 光标 / Trae

Thêm vào file cấu hình MCP：

Sử dụng với Docker （HTTP 模式）

Sử dụng với OAuth 2.0

坚楚2 lớp

Smart Tools （7）：服务器端分页 + 聚合 cho data lớn Base Tools （63）： 1：1 映射 với Haravan API cho detail/CRUD

智能工具

工具	Chức năng
`hrv_orders_summary`	Tổng DT，AOV，状态/来源/取消分解，所以sánh kỳ trước
`hrv_top_products`	上N sản phẩm theo doanh thu + 变体分解
`hrv_order_cycle_time`	中位数/p90 确认/收盘时间，đơn 卡住
`hrv_customer_segments`	RFM 8 段 + 动作建议
`hrv_inventory_health`	Phân loại：out_of_stock / 低 / 死亡 / 健康
`hrv_stock_reorder_plan`	DSR + 重排序点 + 每个变体建议数量

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Haravan MCP

Haravan E-commerce OpenAPI MCP Server — Kết nối AI assistants với Haravan stores.

MCP (Model Context Protocol) server cho phép AI assistants (Claude, Cursor, Trae) tương tác trực tiếp với Haravan APIs: quản lý sản phẩm, đơn hàng, khách hàng, tồn kho, webhooks và nhiều hơn.

English below.

Bắt đầu nhanh

Sử dụng với Claude / Cursor / Trae

Thêm vào file cấu hình MCP:

{
  "mcpServers": {
    "haravan-mcp": {
      "command": "npx",
      "args": ["-y", "haravan-mcp", "mcp", "-t", ""]
    }
  }
}

Sử dụng với Docker (HTTP mode)

# Clone repo
git clone  && cd HaravanMCP

# Cấu hình token
cp docker/.env.example docker/.env
# Sửa docker/.env → điền HARAVAN_ACCESS_TOKEN

# Chạy
docker compose -f docker/docker-compose.yml up -d

# MCP endpoint: http://localhost:4567/mcp
# Health check: http://localhost:4567/health

Sử dụng với OAuth 2.0

# Bước 1: Login
npx haravan-mcp login -a  -s 

# Bước 2: Cấu hình MCP
{
  "mcpServers": {
    "haravan-mcp": {
      "command": "npx",
      "args": ["-y", "haravan-mcp", "mcp", "-a", "", "--oauth"]
    }
  }
}

Kiến trúc 2 lớp

Claude Skill Layer (AI reasoning, insights, formatting)
         │
         │ MCP Protocol
         ▼
MCP Server Layer (pagination, rate limiting, aggregation)
         │
         │ HTTPS + Bearer Token
         ▼
Haravan REST API (apis.haravan.com)

Smart Tools (7): Server-side pagination + aggregation cho data lớn Base Tools (63): 1:1 mapping với Haravan API cho detail/CRUD

Smart Tools

Tool	Chức năng
`hrv_orders_summary`	Tổng DT, AOV, status/source/cancel breakdown, so sánh kỳ trước
`hrv_top_products`	Top N sản phẩm theo doanh thu + variant breakdown
`hrv_order_cycle_time`	Median/p90 time-to-confirm/close, đơn stuck
`hrv_customer_segments`	RFM 8 segments + action suggestions
`hrv_inventory_health`	Phân loại: out_of_stock / low / dead / healthy
`hrv_stock_reorder_plan`	DSR + reorder point + suggested qty per variant
`hrv_inventory_imbalance`	Cross-location imbalance + transfer suggestions

Base Tools (63 tổng)

Category	Tools	Mô tả
Customers	14	CRUD khách hàng + địa chỉ
Orders	13	CRUD đơn hàng + transactions
Products	11	CRUD sản phẩm + variants
Inventory	5	Kiểm kho + locations
Shop	6	Shop info, kho, nhân viên
Content	11	Pages, blogs, articles, script tags
Webhooks	3	Subscribe/unsubscribe

Presets

# Smart tools only (dashboard/analytics)
haravan-mcp mcp -t  --tools "preset.smart"

# Default (smart + detail drill-down)
haravan-mcp mcp -t  --tools "preset.default"

# Full CRUD cho specific resources
haravan-mcp mcp -t  --tools "preset.products,preset.orders"

# Tất cả tools
haravan-mcp mcp -t  --tools "all"

在 GitHub 查看完整 README

安装

npx -y haravan-mcp mcp -t <your_access_token>

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "haravan-mcp": {
      "command": "npx",
      "args": ["-y", "haravan-mcp", "mcp", "-t", "<your_access_token>"]
    }
  }
}