MCP A

MCP A Query API

Service API sederhana untuk mengecek stok barang dan melakukan update stok (inventaris). Service ini berjalan menggunakan Node.js dan Express.

Catatan: Data inventaris tersimpan di memori (in-memory), sehingga data akan kembali ke default setiap kali server di-restart.

Prasyarat

• (versi 14 atau lebih baru disarankan)

Instalasi

1. Clone repositori ini atau download source code.
2. Masuk ke direktori project:

   cd mcp-a-query

1. Install dependencies:

   npm install

Menjalankan Server

Untuk menjalankan server di mode production (atau default):

npm start

Server akan berjalan di port 3001.

API Endpoints

1. Cek Stok Barang

Mendapatkan informasi stok dan harga barang berdasarkan nama item.

• URL: /api/v1/stock
• Method: GET
• Query Params:

- item (string): Nama barang (contoh: buku, pensil, laptop)

Contoh Request:

GET http://localhost:3001/api/v1/stock?item=buku

Contoh Response (Sukses):

{
  "status": "success",
  "item": "buku",
  "stock": 200,
  "price": 30000
}

Contoh Response (Tidak Ditemukan):

{
  "status": "error",
  "message": "Stok untuk meja tidak ditemukan."
}

2. Update Stok Barang

Mengurangi stok barang setelah terjadi pemesanan.

• URL: /api/v1/update-stock
• Method: POST
• Body: JSON

  {
    "item": "buku",
    "quantity": 5
  }

Contoh Response (Sukses):

{
  "status": "success",
  "item": "buku",
  "oldStock": 200,
  "newStock": 195,
  "message": "Stok buku berhasil dikurangi 5 unit"
}

Contoh Response (Gagal - Stok Tidak Cukup):

{
  "status": "error",
  "message": "Stok tidak cukup. Tersedia: 200, diminta: 250"
}