# MSC MCP Server

[![npm version](https://img.shields.io/npm/v/msc-mcp.svg)](https://www.npmjs.com/package/msc-mcp)

MCP Server lấy thông báo từ Hệ thống Mua sắm công (muasamcong.mpi.gov.vn).

## Tính năng

3 tools:
- `get_notification_categories` — Lấy danh sách loại thông báo
- `get_notifications` — Lấy danh sách thông báo theo loại (có phân trang, tìm kiếm)
- `get_notification_detail` — Lấy chi tiết một thông báo theo ID

## Cài đặt

### Dùng npx (khuyên dùng)

Không cần cài đặt, chỉ cần cấu hình MCP client (xem phần Cấu hình bên dưới).

### Cài đặt global

```bash
npm install -g msc-mcp
```

### Từ source

```bash
git clone https://github.com/huydepzai121/mcp_msc.git
cd mcp_msc
npm install
npm run build
```

## Cấu hình

### Claude Desktop

Thêm vào file `claude_desktop_config.json`:

**Dùng npx (khuyên dùng):**

```json
{
  "mcpServers": {
    "msc-mcp": {
      "command": "npx",
      "args": ["-y", "msc-mcp"]
    }
  }
}
```

**Dùng local path:**

```json
{
  "mcpServers": {
    "msc-mcp": {
      "command": "node",
      "args": ["/ĐƯỜNG-DẪN-TỚI/msc_mcp/build/index.js"]
    }
  }
}
```

### Cursor

Thêm vào MCP settings:

**Dùng npx:**

```json
{
  "msc-mcp": {
    "command": "npx",
    "args": ["-y", "msc-mcp"]
  }
}
```

**Dùng local path:**

```json
{
  "msc-mcp": {
    "command": "node",
    "args": ["/ĐƯỜNG-DẪN-TỚI/msc_mcp/build/index.js"]
  }
}
```

## Loại thông báo

| Code | Tên | Tên tiếng Anh |
|------|-----|----------------|
| 1 | Thông báo quản trị | Admin Notice |
| 2 | Thông báo về Hệ thống | System Notice |
| 3 | Lịch bảo trì hệ thống | System maintenance schedule |
| 4 | Thông báo về các khóa đào tạo | Notice of training courses |
| 5 | Hành vi hạn chế cạnh tranh | Anti-competitive behavior |
| 6 | Thông báo khác | Other notices |

## Yêu cầu

- Node.js >= 18