# Device Log MCP Server

A simple **Model Context Protocol (MCP)** server written in Python using the **FastMCP SDK**.  
This server simulates reading logs from multiple device services and exposes them as MCP tools.

---

## 🚀 Features

- Exposes 4 tools:
  - `get_activation_logs(serial_number)`
  - `get_lan_logs(serial_number)`
  - `get_wlan_logs(serial_number)`
  - `get_kafka_status(serial_number)`
- Simulates real logs for demo/testing.
- Runs in **stateless HTTP JSON mode** → easy to test using `curl`.
- Default port: **4000**

---

## 🧩 Requirements

- Python ≥ 3.10  
- MCP SDK (FastMCP)

Install dependencies using either `uv` or `pip`:

```bash
# Option 1: using uv (recommended)
uv add "mcp[cli]"

# Option 2: using pip
python -m pip install "mcp[cli]"
```

---

## ⚙️ Running the server

```bash
uv run python mcp_server.py
```

Output example:

```
🚀 Starting Device Log MCP Server on port 4000...
INFO:     Uvicorn running on http://127.0.0.1:4000
```

---

## 🧪 Testing via curl

You can call each tool directly via `/mcp` endpoint.

### Activation logs
```bash
curl -X POST http://127.0.0.1:4000/mcp      -H "Content-Type: application/json"      -H "Accept: application/json"      -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_activation_logs","arguments":{"serial_number":"SN12345"}}}'
```

### LAN logs
```bash
curl -X POST http://127.0.0.1:4000/mcp      -H "Content-Type: application/json"      -H "Accept: application/json"      -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_lan_logs","arguments":{"serial_number":"SN12345"}}}'
```

### WLAN logs
```bash
curl -X POST http://127.0.0.1:4000/mcp      -H "Content-Type: application/json"      -H "Accept: application/json"      -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_wlan_logs","arguments":{"serial_number":"SN12345"}}}'
```

### Kafka status
```bash
curl -X POST http://127.0.0.1:4000/mcp      -H "Content-Type: application/json"      -H "Accept: application/json"      -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"get_kafka_status","arguments":{"serial_number":"SN12345"}}}'
```

---

## 🧰 Example response

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[SN12345] Activation completed at step 4"
      }
    ]
  }
}
```

---

## 📦 Project structure

```
device-log-server/
├── mcp_server.py
└── README.md
```