Ril

MCP Server，讓 Claude Desktop 能直接讀取並分析 ril-log-parser 輸出的 JSON 報告，展示 AI 工具輔助 MODEM 開發的實際應用。

安裝

pip install mcp

Clone 專案

git clone https://github.com/linyuhang617/ril-mcp-server.git cd ril-mcp-server

Claude Desktop 設定

編輯 ~/Library/Application Support/Claude/claude_desktop_config.json：

將下方的 /your/path/to 替換為你實際 clone 的路徑：

{ "mcpServers": { "ril-analyzer": { "command": "python3", "args": ["/your/path/to/ril-mcp-server/server.py"] } } }

例如 clone 在 ~/Projects/ 下，路徑就是 /Users/yourname/Projects/ril-mcp-server/server.py

儲存後重啟 Claude Desktop。

可用 Tools

Tool	說明
list_logs	列出指定目錄下所有可分析的 JSON 報告檔案
load_report	載入報告，回傳摘要與可查詢的資料區塊清單
get_errors	回傳錯誤清單，讓 Claude 分析並解釋每個錯誤
get_at_commands	回傳 AT Command 清單，包含指令、回應與解譯
get_registration_status	回傳網路註冊流程與最終狀態
get_sim_status	回傳 SIM 卡狀態流程與最終狀態

Demo Script

啟動 Claude Desktop 並連上 ril-analyzer 後，可以依序問以下問題：

1. 「有哪些 log 可以分析？」 Claude 列出 samples/ 下的 JSON 檔案清單。

2. 「載入 /your/path/to/ril-mcp-server/samples/report.json，給我一個概況」 Claude 說出 total_lines、error_count、SIM 與 registration 狀態。

3. 「這份 log 有什麼問題？」 Claude 列出錯誤並解釋可能原因。

4. 「訊號強度如何？連的是哪家電信商？」 Claude 從 AT Command 資料回答訊號強度、電信商名稱與接入技術。

5. 「這台手機的網路和 SIM 狀態都正常嗎？」 Claude 綜合 registration flow 和 SIM flow 給出整體判斷。

執行測試

python3 tests/test_tools.py

專案結構

ril-mcp-server/ server.py MCP Server 主體 tools.py tool 邏輯 tests/ test_tools.py 單元測試 samples/ report.json 範例報告（來自 ril-log-parser） README.md

與 ril-log-parser 的關係

ril-log-parser（C++）負責解析原始 log 並輸出 report.json；ril-mcp-server 透過 MCP tools 將這份報告提供給 Claude Desktop 進行自然語言分析。