
Qubic Mcp
io.github.fyllepo由 GitHub 帳號 fyllepo 發布v0.2.0更新於 Oct 24, 2026
MCP server for Qubic — balances, prices, transfers, wallets, and more.
概覽
在本機執行的 MCP 伺服器,讓 AI 助理查詢 Qubic 區塊鏈:餘額、轉帳、價格、QX 訂單簿、網路狀態與智慧合約。
- 可以做什麼
- 查詢 Qubic 位址與已儲存錢包的餘額、轉帳紀錄、交易、目前 tick 與網路狀態、挖礦階段、computor 與富豪榜。比較三個來源的 QUBIC 價格,在 QU 與 USD 之間換算,列出已註冊代幣並讀取 QX 去中心化交易所訂單簿。註冊智慧合約介面定義並依名稱查詢,自動完成二進位編碼與解碼,也可執行原始 base64 合約查詢。在本機儲存、列出與刪除錢包位址、自訂網路與合約定義。驗證位址格式並取得區塊瀏覽器連結。讀取內建 Qubic 參考文件,執行預設的投資組合、市場與研究提示詞。
- 適用情境
- 適合用自然語言查看 Qubic 餘額、轉帳、價格或市場資料,也適合在本機 lite 節點上開發與測試 Qubic 智慧合約,省去手動編碼二進位 RPC 呼叫。
- 執行需求
- 透過 npx 或全域 npm 安裝後在本機執行,需要 Node.js。不需帳號、API 金鑰或環境變數;選用變數如 QUBIC_RPC_URL、QUBIC_API_URL 與 MCP_HTTP_PORT 可覆寫網路或改用 HTTP 傳輸。需要連線至 Qubic RPC 端點與價格來源的網路存取。本機資料儲存在使用者家目錄下。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Qubic Mcp,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
qubic-mcp
MCP server for the Qubic cryptocurrency — enabling AI assistants to interact with the Qubic network.
[npm version] [CI] [License: MIT] [PRs Welcome]
Overview
qubic-mcp is an open-source Model Context Protocol (MCP) server that gives AI assistants — Claude, ChatGPT, Copilot, Cursor, and others — native access to the Qubic blockchain.
Query balances, inspect transactions, monitor the network, trade on QX, switch between networks, and interact with smart contracts — all through natural language.
What's New in v0.4
- Smart Contract Profiles — Register custom SC interface definitions, then query them by name with automatic binary encoding/decoding
- Network Management — Save and switch between mainnet, testnet, or your own local/lite node at runtime
- Epoch Computors — Query the 676 computor identities for any epoch
- MCP Prompts — Predefined workflows for portfolio analysis, market overview, and research
- MCP Resources — Qubic reference documentation (network, tokenomics, smart contracts, address format)
- HTTP Transport — Run as a standalone HTTP server for remote deployment
Features
Blockchain Query Tools
- Balance & Transfers — Query any Qubic address balance and transfer history
- Transactions — Look up transaction details by ID
- Network Status — Current tick, epoch, supply, burned QUs, active addresses, market cap
- Mining Phase — Current MINING/IDLE phase, cycle progress, and XMR marathon status
- Epoch Computors — List all 676 computor identities for a given epoch
- Rich List — Top holders ranked by balance
Market & Analytics
- Token Price — Real-time QUBIC price compared across 3 sources (CoinGecko, Qubic API, CryptoCompare)
- QU/USD Converter — Convert between QU and USD at live rates
- Token Registry — List all registered Qubic tokens with issuer and website
- QX DEX Orderbook — Live ask/bid orders for any token on the QX decentralized exchange
Smart Contract Tools
- Register Contract — Save a custom SC interface definition (function names, input/output field schemas)
- Query Contract — Query a registered SC function by name with automatic binary encoding/decoding
- Raw SC Query — Low-level smart contract query with base64 input/output for advanced use
- List/Remove Contracts — Manage your registered contract definitions
Local Management
- Wallet Management — Save wallet addresses locally for quick access
- Network Switching — Save and switch between mainnet, testnet, or custom RPC endpoints at runtime
- Address Validation — Check format and on-chain activity
- Explorer Links — Direct links to the official Qubic block explorer
AI Context
- MCP Resources — Qubic reference docs (network, tokenomics, smart contracts, address format) available as context
- MCP Prompts — Predefined workflows: portfolio analysis, market overview, and Qubic research
Quick Start
Works with any MCP-compatible AI client — Claude, ChatGPT, Copilot, Cursor, Windsurf, Gemini, JetBrains, and more.
Add this to your client's MCP config:
Where to find the config file
For other clients, check your app's MCP documentation — the config above is universal.
Then just ask in plain English:
Wallet Management
Balances & Transfers
Price & Market
Network & Mining
QX DEX & Tokens
Network Switching
Smart Contract Queries
Smart Contract Development Workflow
One of the most powerful features of qubic-mcp is its smart contract profile system. If you're developing a Qubic smart contract on a local lite network, you can use the MCP to test your contract's RPC interface directly through your AI assistant.
Why This Matters
Qubic smart contracts communicate via binary-encoded structs over the /v1/querySmartContract RPC endpoint. Without tooling, this means manually encoding fields into base64, making HTTP calls, and decoding binary responses — error-prone and tedious.
With qubic-mcp, you register your contract's interface once, and then query it by name with human-readable input and output. Your AI assistant handles all the binary encoding/decoding automatically.
Step-by-Step
1. Point the MCP at your test network:
Your MCP server now talks to your local lite node instead of mainnet. This persists across sessions in ~/.qubic-mcp/networks.json.
2. Register your contract's interface:
Tell the assistant your contract's index and function definitions. Here's a simple counter contract at index 10 as an example:
The assistant will call register_contract with the proper field schema JSON. The definition is saved to ~/.qubic-mcp/contracts.json and persists across sessions.
Supported field types: uint8, uint16, uint32, uint64, int8, int16, int32, int64, identity (60-char Qubic address / 32-byte pubkey), padding (skipped bytes).
Fields support count for arrays and enum for value-to-label mapping.
3. Query your contract by name:
The MCP encodes your input into binary, calls the RPC endpoint, and decodes the response into named fields:
4. Switch back to mainnet when done:
Installation
From npm (recommended)
From source
Configuration
Network Management
The easiest way to configure which Qubic network you talk to is through the built-in tools — no env vars needed:
- Add a custom network:
add_network— save your local node's IP with a friendly name - Switch networks:
switch_network— toggle between mainnet, testnet, or any saved network - List networks:
list_networks— see all available networks and which is active
Networks are saved to ~/.qubic-mcp/networks.json and persist across sessions. Built-in networks (mainnet, testnet) are always available.
Environment Variables
For advanced use or CI environments, you can also configure via env vars. See .env.example.
HTTP Transport
By default the server uses stdio, which is what most MCP clients expect. To run it as a standalone HTTP endpoint instead, set MCP_HTTP_PORT:
The server exposes a single /mcp endpoint that supports the MCP Streamable HTTP transport:
- POST /mcp — send JSON-RPC requests (initialize creates a session)
- GET /mcp — open an SSE stream for server notifications (requires
mcp-session-idheader) - DELETE /mcp — terminate a session
All Tools
Blockchain
Market & Tokens
Smart Contract Development & Testing
Wallets
Network Management
Utility
MCP Resources
MCP Prompts
Local Data
qubic-mcp stores local data in ~/.qubic-mcp/:
Security
This project takes security seriously, especially given it interacts with a financial network.
- No private keys — This server is read-only. It never asks for, stores, or transmits private keys or seeds.
- Input validation — All inputs are validated with Zod schemas before processing.
- No telemetry — No analytics, tracking, or data collection of any kind.
- Auditable — Fully open source. Read every line.
See SECURITY.md for our vulnerability disclosure policy.
Contributing
Contributions are welcome and encouraged! Whether you're fixing a bug, adding a new tool, improving docs, or suggesting an idea — we'd love your help.
See CONTRIBUTING.md for guidelines.
Roadmap
See ROADMAP.md for our planned features and future direction.
License
MIT — see LICENSE.
Disclaimer
This software is provided "as is" without warranty of any kind. The authors and contributors are not responsible for any loss of funds, data, or other damages resulting from the use of this software.
This tool interacts with the Qubic blockchain where transactions are irreversible. Users are solely responsible for verifying all information and understanding the risks. This software does not provide financial advice.
來源:README.md,提交 7ddb749
工具
0版本歷史
1- v0.2.0最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分