# ByteScope MCP

> ByteScope MCP 是完全離線的檔案分析 MCP 伺服器：算雜湊、判斷檔案類型、解析 pcap、ELF 與憑證、查 USB 與 BLE ID，還能產生測試檔案，npx 一行就裝好。

- URL: https://bytescope.dev/zh-Hant/mcp/
- Locale: zh-Hant · Also: [en](https://bytescope.dev/en/mcp.md) · [ja](https://bytescope.dev/ja/mcp.md)
- Runs: 本機版在你的電腦上跑，完全不碰網路。線上版只處理每一次請求，什麼都不留。
- Requires: The page reads in any modern browser. The server is not a browser tool: the local one runs with npx on Node.js 20 or newer, fully offline, and the hosted one is an HTTP endpoint any MCP client can add.
- Updated: 2026-09-08

## What it does

ByteScope MCP 是完全離線的 MCP 伺服器。`npx -y @bytescope/mcp` 會在你自己的電腦上用 stdio 啟動，完全不碰網路：沒有遙測、不呼叫任何 API、不用金鑰也不用帳號。裡面跑的就是這個網站各個工具背後的 `core-*` 套件，打包成一個檔案給寫程式的 agent 用。

### 拿來分析檔案的 MCP 伺服器

agent 很會推理位元組，卻很不會憑記憶把位元組拼對。這個伺服器直接給它真的東西：從 magic bytes 判斷檔案類型並附上信心度、算 CRC 或從已知的輸入輸出反推 CRC 參數、X.509 憑證與 CSR、子網路、pcap／pcapng 封包、ELF 的 header 與符號、Intel HEX 和 UF2 的位址區段、HID report descriptor，還有沒指定就不給 GPS 的 EXIF。`generate_fixture` 會做出結構正確的 PNG、ZIP、pcap、PDF、MP4、X.509 測試檔案，跟測試檔案產生器那頁用的是同一套產生器。

### 雜湊 MCP 伺服器，查不到就回 `found: false`

`hash_bytes` 會回傳你給的位元組的 MD5、SHA-1、SHA-256、SHA-512 與 CRC-32。`lookup_*` 這組工具從真實的對照表回答：USB 廠商與產品 ID、BLE UUID、HID usage、MIDI 控制器編號與廠商 ID、連接埠、HTTP 狀態碼、檔案簽章。表裡沒有的 ID 一律回 `found: false`，不會編一個看起來很合理的答案。

### 只收位元組，不收路徑

二進位輸入一律是 base64 或 hex 字串。工具不收檔案路徑，所以 agent 沒辦法把你沒打算分享的硬碟檔案交出去，本機版和線上版也能吃同一份 schema。本機版每次呼叫最多 8 MB。`https://bytescope.dev/api/mcp` 的線上版是盡力提供、什麼都不存，上限 4 MB；超過就會請 agent 改用本機版。這頁的工具表，是在建置網站時直接從伺服器本身的工具清單讀出來的。

## Limits

Does not read file paths, does not call any LLM or network API from the local server, and does not store requests. The hosted endpoint is best effort and caps a payload at 4 MB.

## FAQ

### ByteScope MCP 會把我的檔案傳出去嗎？

本機版不會。它在你電腦上的 Node 裡跑、走 stdio，程式裡根本沒有連網路的路徑。線上版本質上不一樣：你傳的位元組會送到 Cloudflare Worker，在那次請求裡處理完就結束，不會儲存。不想貼進網頁表單的東西，就用本機版處理。

### 怎麼加到 Claude Code 或 Cursor？

Claude Code 用 `claude mcp add bytescope -- npx -y @bytescope/mcp` 一行就好。會讀 `.mcp.json` 的客戶端可以直接用這頁的片段；Cursor 則是把同一段 `mcpServers` 放進 `.cursor/mcp.json`（要所有專案都能用就放 `~/.cursor/mcp.json`）：`command` 是 `npx`，`args` 是 `-y @bytescope/mcp`。需要 Node.js 20 以上。

### 為什麼工具不收檔案路徑？

讓 agent 傳本機路徑，等於開了一條路讓它讀到你沒打算給的檔案。只收位元組，伺服器處理的就只有你交出去的東西。而且同一份 schema 拿到線上版也能用，你硬碟上的路徑在那邊本來就沒有意義。

### 線上版超過 4 MB 會怎樣？

那次呼叫會失敗，並回一段訊息請你改用本機版 `npx @bytescope/mcp`，本機版最多收 8 MB。不會偷偷截斷。

### 要付費或 API 金鑰嗎？

不用。沒有金鑰、沒有帳號、沒有額度。本機版在你的電腦上跑，線上版跑在 Cloudflare Workers，濫用靠平台的速率限制擋掉。

## Related tools

- [Test File Generator](https://bytescope.dev/zh-Hant/test-files.md) — 把 generate_fixture 的產生器做成下載頁：PNG、PDF、MP4、ZIP、pcap、X.509 等等。
- [File Type Identifier](https://bytescope.dev/zh-Hant/file-type.md) — 在瀏覽器裡從 magic bytes 判斷檔案類型，也就是 detect_file_type 背後那一頁。
- [File Hash Calculator](https://bytescope.dev/zh-Hant/file-hash.md) — 在瀏覽器裡算本機檔案的 MD5、SHA-1、SHA-256，也就是 hash_bytes 背後那一頁。