pluginmd/haravan-mcp

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

21 stars 7 forks 品質 69 トレンド 10Apache-2.0

Haravan E-commerce MCP Server — Connect AI assistants (Claude, Cursor, Trae) to Haravan stores. 70 tools: orders, products, customers, inventory, RFM segmentation, smart analytics.

概要

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. : Server-side pagination + aggregation cho data lớn : 1:1 mapping với Haravan API cho detail/CRUD Ngoài MCP Server (70 tools), 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 tools hiệu quả nhất. (từ references/insights-formulas.

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>

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

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