# Getting Started with Hyperion MCP Server
This guide will help you install, configure, and start using the Hyperion MCP Server.
## Prerequisites
Before you begin, ensure you have:
- **Node.js** v18 or higher
- **npm** or **yarn** package manager
- A code editor (VS Code recommended)
- Basic understanding of blockchain concepts
## Installation
### Method 1: NPM Installation (Recommended)
```bash
npm install -g hyperion-mcp-server
```
### Method 2: Via Smithery
```bash
npx @smithery/cli install hyperion-mcp-server
```
### Method 3: From Source
```bash
# Clone the repository
git clone https://github.com/cuongpo/hyperion-mcp-server.git
# Navigate to the directory
cd hyperion-mcp-server
# Install dependencies
npm install
# Build the project
npm run build
```
## Configuration
### 1. Environment Setup
Create a `.env` file in the project root (optional):
```bash
# Hyperion Network Configuration
HYPERION_RPC_URL=https://rpc.hyperion-testnet.metisdevops.link
HYPERION_CHAIN_ID=133717
HYPERION_EXPLORER_URL=https://hyperion-testnet.metisdevops.link
# Optional: Default wallet configuration
DEFAULT_WALLET_NAME=my-wallet
```
### 2. MCP Client Configuration
#### For Claude Desktop
Add to your Claude Desktop configuration file:
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"hyperion": {
"command": "node",
"args": ["/path/to/hyperion-mcp-server/build/index.js"]
}
}
}
```
#### For Cline (VS Code Extension)
Add to your Cline MCP settings:
```json
{
"mcpServers": {
"hyperion": {
"command": "node",
"args": ["./build/index.js"],
"cwd": "/path/to/hyperion-mcp-server"
}
}
}
```
## First Steps
### 1. Create Your First Wallet
Once the MCP server is running, you can create a wallet:
```
Create a new Hyperion wallet named "my-wallet"
```
The server will respond with:
- Wallet address
- Mnemonic phrase (save this securely!)
**⚠️ IMPORTANT**: Save your mnemonic phrase in a secure location. It's the only way to recover your wallet!
### 2. Get Testnet Tokens
To interact with the Hyperion testnet, you need tMETIS tokens:
1. Visit the [Hyperion Testnet Faucet](https://hyperion-testnet.metisdevops.link/faucet)
2. Enter your wallet address
3. Request testnet tokens
4. Wait for confirmation (usually 1-2 minutes)
### 3. Check Your Balance
Verify your tokens arrived:
```
Check the balance of my wallet
```
### 4. Send Your First Transaction
Try sending some tokens:
```
Send 0.1 tMETIS to 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
```
## Quick Examples
### Example 1: Create and Fund a Wallet
```
1. Create a new wallet named "test-wallet"
2. Show me the wallet address
3. Check the balance
```
### Example 2: Deploy an ERC20 Token
```
1. Deploy an ERC20 token named "MyToken" with symbol "MTK"
2. Set initial supply to 1000000
3. Make it mintable
```
### Example 3: Query Network Information
```
Show me the current Hyperion network information
```
## Verification
To verify your installation is working correctly:
1. **Check Server Status**
```bash
npm run dev:local
```
You should see: "Hyperion MCP Server running on stdio"
2. **Test Wallet Creation**
Create a test wallet and verify you receive an address
3. **Test Network Connection**
Query network info to ensure RPC connectivity
## Next Steps
Now that you're set up, explore:
- **[Wallet Management](./wallet-management.md)** - Learn advanced wallet operations
- **[Blockchain Operations](./blockchain-operations.md)** - Send transactions and query data
- **[Token Operations](./token-operations.md)** - Deploy and manage tokens
- **[Examples](./examples.md)** - See real-world use cases
## Troubleshooting
### Server Won't Start
- Verify Node.js version: `node --version` (should be v18+)
- Check if port is already in use
- Ensure all dependencies are installed: `npm install`
### Can't Connect to Network
- Verify RPC URL is correct
- Check your internet connection
- Try alternative RPC: `https://rpc.hyperion-testnet.metisdevops.link`
### Wallet Issues
- Ensure mnemonic/private key is valid
- Check wallet is properly imported
- Verify wallet has sufficient balance for gas
For more issues, see [Troubleshooting](./troubleshooting.md).
---
**Ready to dive deeper?** Continue to [Wallet Management](./wallet-management.md) →
