README.md•2.5 kB
# 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
```