Installation

Installing OctoMCP

Prerequisites

• Node.js (v16 or higher)

• npm or yarn

• A Solana wallet with some SOL for transaction fees

Build from source

# Clone the repository
git clone https://github.com/octonetai/octomcp.git
cd octomcp

# Install dependencies
npm install

# Build the project
npm run build

Setup

1. Build the project to generate the build folder

npm run build

1. Configure your AI assistant's MCP host to use OctoMCP by creating a configuration file (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "OctoMCP": {
      "command": "node",
      "args": [
        "/path/to/your/octomcp/build/index.js"
      ],
      "env": {
        "SOLANA_WALLET_PUBLIC_KEY": "YOUR_WALLET_PUBLIC_KEY",
        "SOLANA_WALLET_SECRET_KEY": "[SECRET_KEY_ARRAY_NUMBERS]",
        "SOLANA_DEFAULT_CLUSTER": "devnet"
      }
    }
  }
}

Replace the placeholders:

• /path/to/your/octomcp/build/index.js - The full path to the built index.js file

• YOUR_WALLET_PUBLIC_KEY - Your Solana wallet public key (e.g., GsAqi6PLSjfDX271Rf3u8wtecidWEpYoYFswmG9wF4QW)

• [SECRET_KEY_ARRAY_NUMBERS] - Your Solana wallet secret key as a JSON array of numbers

• devnet - The default Solana cluster (can be devnet or mainnet)

Wallet Configuration Options

OctoMCP supports multiple ways to provide wallet information:

1. Environment variables (as shown in the config above)

2. Command line arguments: --wallet-public-key and --wallet-secret-key

3. Config file: Create a solana-config.json file with wallet information

4. Auto-generated: If no wallet is provided, one will be generated automatically on deployment

Getting Your Wallet Secret Key

For security reasons, you need to provide your wallet's secret key as an array of numbers. You can export this from most Solana wallets or use the Solana CLI:

solana-keygen dump-keypair --keypair /path/to/your/keypair.json

⚠️ IMPORTANT SECURITY WARNING ⚠️ Never share your secret key with anyone. Keep your MCP configuration file secure and never commit it to public repositories.