mcp2viv

mcp2viv is a CLI tool to deploy MCP tools into Vivgrid.
It connects to your configured MCP servers, lists available tools, and lets you selectively deploy them.

📌 Prerequisites

Before using mcp2viv, you must install the following tools:

# Install yomo
curl -fsSL https://get.yomo.run | sh

# Install yc (Vivgrid CLI)
curl "https://bina.egoist.dev/vivgrid/yc" | sh

Check they are available in your PATH:

yomo -v
yc -v

Also ensure you have:

• Node.js v18.17 or higher
• npm or pnpm installed

🚀 Usage

You can run it directly with npx:

$ npx mcp2viv -h                
Usage: mcp2viv [options]

Options:
  -c, --config <path>    mcp config file (default: "mcp.json")
  -s, --secret <secret>  vivgrid app secret
  -h, --help             display help for command

npx mcp2viv -c mcp.json -s <vivgrid-app-secret>

An example mcp.json

📄 Example Run

$ mcp2viv -c mcp.json -s your-vivgrid-secret

📦 Available Tools:
╔════╤══════════════╤══════════════════════════╤════════════════════════════════════╗
║    │ Server       │ Name                     │ Description                        ║
╟────┼──────────────┼──────────────────────────┼────────────────────────────────────╢
║ 1  │ amap         │ maps_direction_walking   │ Walking route planning             ║
║ 2  │ amap         │ maps_direction_driving   │ Driving route planning             ║
╚════╧══════════════╧══════════════════════════╧════════════════════════════════════╝

? Are you sure to deploy maps_direction_walking from amap to vivgrid? (y/N)