io.github.vnish-global由 GitHub 帳號 vnish-global 發布v1.0.0更新於 Oct 25, 2026
Read-only VNISH firmware metadata, Ninja guidance and input-based mining economics calculations.
唯讀的遠端 MCP 伺服器，用來查詢 VNISH 韌體目錄記錄、精選 Ninja 指南，並依輸入計算示範性的 ASIC 挖礦收益情境。
Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/io.github.vnish-global%2Fvnish-global-operator/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。
{
"mcpServers": {
"vnish-global-operator": {
"type": "http",
"url": "https://vnish.global/ai/mcp/index.php"
}
}
}The remote MCP endpoint and connection guides are now published:
https://vnish.global/ai/mcp/index.phpPublic HTTPS verification with the official MCP JavaScript SDK 1.30.0 passed all 7 checks: PHP execution, protocol initialization, tool listing, resource access and one call to each of the three read-only tools. The negotiated protocol was 2025-11-25. The two guide files, their stylesheet and the catalog snapshot matched the prepared release by SHA-256 and byte count.
Connection inside native ChatGPT and Claude accounts has not been tested. This result does not claim app-directory approval or physical miner testing.
The original pre-deployment snapshot is preserved unchanged below. Its planned-publication wording records the earlier state.
Status: NOT YET DEPLOYED. This is a reviewed source package and deployment candidate. The HTTPS endpoint and new connection-guide URLs below are planned. This README does not claim that ChatGPT or Claude has connected to the service or approved a directory listing.
The PHP server exposes three read-only tools using public VNISH Global catalog metadata, selected VNISH Ninja references and an ROI ASIC arithmetic scenario. It does not connect to miners, install firmware, run commands, fetch arbitrary URLs, use credentials or store tool arguments. Existing Operator skills and earlier MCP implementations are preserved.
The six files under public/ are an additive deployment for vnish.global:
Planned endpoint: https://vnish.global/ai/mcp/index.php.
Planned guides: https://vnish.global/ai/connect/ and https://vnish.global/ru/ai/connect/.
Deploy only public/ paths, after checking for existing files. Verify PHP execution and POST behavior on the hosting runtime. No existing site root, shared navigation, styles, JavaScript, sitemap, robots or security configuration is part of this package. GET and DELETE on the MCP endpoint return 405; connection guides are separate HTML pages. Test and data-source files do not belong in the web root.
lookup_firmware: exact catalog model ID, with optional board code and version. Returns filename, size, SHA-256 and Global source URLs. Multiple matching records stay ambiguous. A catalog record is not evidence of compatibility, authenticity or successful hardware testing.find_ninja_reference: fixed EN/RU guides for control-board identification, installation SSH errors and return-to-stock preparation. It does not determine whether a recovery method applies to a particular device.calculate_roi_scenario: gross pre-fee hashrate, average wall power, modeled fee, gross daily hashprice, electricity tariff and operating hours. All inputs are supplied by the caller. Both revenue and energy scale by the same operating-hours assumption. The output is contribution after the modeled fee and electricity, excluding other expenses; it is not net profit, ROI or a forecast.The server also exposes three resources: the model ID index, snapshot provenance and scenario methodology. Resource URIs are identifiers used with MCP resources/read, not promised web pages.
data/source-catalog.json is a copy of the public catalog at https://vnish.global/api/v1/firmware-catalog.json. data/catalog-provenance.json records its retrieval timestamp and SHA-256. The bundled snapshot contains 47 models and 148 build records. A snapshot is not a live availability check. No scheduled update process is included.
Selected identifiers and scenario numbers are sent to the server. Application code does not persist arguments; standard hosting/CDN logs may record request metadata. Passwords, account data, miner addresses and configuration files are unnecessary.
Protocol versions: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26. Modern requests use server/discover, per-request metadata and mirrored headers. Legacy clients use initialize. The server creates no session ID and returns JSON instead of SSE. It provides no subscriptions, elicitation, sampling, batch requests or device operations.
Present Origin headers must exactly match the three project domains, https://chatgpt.com or https://claude.ai; absent Origin is permitted for server clients. Inputs are bounded to 32 KiB and depth 32. IDs must be strings or numbers whose integer value is in the safe range from -(2^53-1) to 2^53-1, so request correlation cannot be silently rounded.
Requirements: Node.js 20.10 or newer; Python 3.9 or newer for builders. Runtime PHP hosting is separate from the test dependencies.
Pinned test dependencies:
@php-wasm/universal 3.1.54@php-wasm/node-8-4 3.1.54@modelcontextprotocol/sdk 1.30.0A pnpm lockfile pins transitive dependencies. From this directory:
The tests execute the actual endpoint in PHP 8.4 WebAssembly, then start a temporary HTTP bridge bound to 127.0.0.1 and call it with the official SDK's StreamableHTTPClientTransport. The bridge closes when testing finishes. Tests cover tools, resources, current protocol metadata, origin validation, bounded inputs, scenario arithmetic, negative results and malformed/fractional/oversized request IDs. They need no production account, credentials or miner.
Generated receipts go in ignored test-results/. Tests do not access arbitrary network destinations; example invalid URLs are negative-test fixtures. No browser scripts or private QA artifacts are included.
Rebuild the public snapshot and guides from the bundled public source:
A successful local test does not establish public hosting or an end-user client connection. After deployment, verify the public HTTPS endpoint and then test actual client connections.
The connection pages' canonical/language URLs, their local connect.css, and the displayed MCP URL will work only after the public/ files are published. Guide links to the current public catalog, existing Ninja and ROI ASIC references, official setup documentation and the existing Operator repository are independent of that deployment. The repository link deliberately points to the existing repository root until this package is published.
Setup guidance was checked against official documentation on 2026-09-17. Account and workspace policy can affect available connection options.
來源：remote-mcp/README.md，提交 c2359cf
Look up a VNISH Global catalog record
Find records in a dated snapshot of the public vnish.global firmware catalog. Use the exact model ID; narrow by board code and version if known. Returns file size, SHA-256 and source links. A catalog record does not establish device compatibility, package authenticity, or successful hardware testing. Does not download or install firmware.
versionmodel_id必填board_platformFind a VNISH Ninja reference
Return a selected public VNISH Ninja guide about control-board identification, installation SSH errors, or return-to-stock preparation. A reference is not a device-specific installation or recovery instruction. No device connection or action is performed.
topic必填languageCalculate an ROI ASIC daily scenario
Calculate hypothetical daily revenue after an illustrative time/hashrate-based developer fee and electricity cost using user-supplied inputs. H*q*(hours/24)*(1-f/100) - (W/1000)*hours*t. This is a scenario, not a profit forecast or a statement of actual VNISH fees. Use pre-fee gross hashrate; do not deduct the fee twice.
power_w必填hashrate_th_s必填dev_fee_percent必填electricity_usd_per_kwh必填operating_hours_per_dayhashprice_usd_per_th_day必填已滿足適用檢查項的 100%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
pnpm install --frozen-lockfilepnpm testpnpm run build