mcp-growi
MCP (Model Context Protocol) server for Growi Finance — enables AI agents and autonomous bots to interact programmatically with the GrowiHFVault smart contract on Arbitrum.
Security
Read this before configuring a keystore or private key.
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y [email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add io.github.growi-defi-mcp-growi -- npx -y mcp-growi@0.2.0在終端機中執行。
{ "mcpServers": { "io.github.growi-defi-mcp-growi": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
MCP (Model Context Protocol) server for Growi Finance — enables AI agents and autonomous bots to interact programmatically with the GrowiHFVault smart contract on Arbitrum.
Read this before configuring a keystore or private key.
MCP server for Growi Finance — programmatic interaction with the GrowiHFVault on Arbitrum
mcp-growi exposes execute_transaction, which signs and broadcasts Arbitrum transactions with the locally configured wallet. Inside any MCP client (Claude Desktop, Claude Code, etc.) the LLM has full authority over what gets signed — every tool call is initiated by the model in response to your prompts and anything else it has access to.
This makes the MCP a "confused deputy": if untrusted content reaches the model — a web page fetched by another tool, a document opened in the session, a sibling MCP server controlled by an attacker — a prompt-injection payload inside that content can instruct the model to drain the configured wallet.
KEYSTORE_PATH or PRIVATE_KEY in a session that has access to untrusted content. If the same client has browsing tools, document-readers, or any other MCP server, treat the session as compromised by default.mcp-growi and fund it only with the amount you intend to deposit. Never reuse your main custody wallet.mcp-growi@latest. When a security release is published, the built-in version check blocks all operations until you upgrade. Pinning to an older version defeats this.The server has its own defenses against the most direct drain paths, but they cannot prevent every form of misuse:
execute_transaction only signs calls to four (contract, selector) pairs — USDC.approve, GWHF.approve, vault.deposit, vault.withdraw. A prompt-injection payload calling USDC.transfer(attacker, balance) is rejected before signing.approve calls are accepted only when the spender is the GrowiHFVault address. deposit and withdraw amounts must be greater than zero.These guards close the easy attacks but do not make the keystore safe in arbitrary sessions. Treat it as a hot wallet, not custody.
The contract is verified on Arbiscan — you can check the source code and ABI at: https://arbiscan.io/address/0x928ed672e6eabb7a565c5eb9aac15e3cf6a18388#code
The ABI is included in this package (src/contract/abi.ts) so no external calls are needed at runtime.
src/
├── index.ts # Server entrypoint + npm version check
├── contract/ # On-chain interaction layer (viem)
│ ├── abi.ts # GrowiHFVault + ERC20 ABIs
│ ├── client.ts # Arbitrum public client + contract/token/HL addresses
│ └── index.ts
├── locks/
│ └── lock-period.ts # Arbitrum deposit lock + Hyperliquid 24h withdraw lockup
└── tools/ # MCP tool definitions
├── read.ts # Read-only on-chain queries
├── write.ts # Transaction prep + signing (keystore/privkey)
└── index.ts
Add the following to your Claude MCP config (claude_desktop_config.json or .mcp.json):
{
"mcpServers": {
"growi": {
"command": "npx",
"args": ["-y", "mcp-growi@latest"],
"env": {
"KEYSTORE_PATH": "/path/to/your/wallet.json",
"KEYSTORE_PASSPHRASE": "your_passphrase"
}
}
}
}
Important: use
mcp-growi@latest(not justmcp-growi) to ensure the MCP auto-updates every time Claude starts. If your version is outdated, or the npm registry is unreachable, all tools (read and write) will be blocked until verification succeeds.
Alternative — plain private key (less secure):
"env": { "PRIVATE_KEY": "0x..." }
Optional — custom RPC endpoint:
"env": { "RPC_URL": "https://arb-mainnet.g.alchemy.com/v2/YOUR_KEY" }
Restart Claude Desktop/Code after saving. The tools will be available once the version check passes — if calls return a version-block error, see the Security section above.
npm install
npm run build
npm start
MCP server for Growi Finance — programmatic interaction with the GrowiHFVault on Arbitrum
{ "mcpServers": { "io.github.growi-defi-mcp-growi": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
MCP Growi 透過 stdio 在本機執行。
上次檢查時間:2026-11-09。 MCP server for Growi Finance — programmatic interaction with the GrowiHFVault on Arbitrum