spheron protocol.com
spheron protocol.com logo

Spheron Protocol

Integrates with Spheron Protocol SDK to deploy and manage compute resources through natural language, enabling users to...

Created byApr 23, 2025

Spheron Network MCP Plugin

This MCP (Model Context Protocol) plugin integrates with the Spheron Protocol SDK to provide compute deployment and management capabilities directly through Claude.

Recent Fixes

  • **ES Module Compatibility**: Fixed fs-extra import to work properly with ES modules
  • **BigInt Serialization**: Added proper handling of BigInt values in API responses to prevent JSON serialization errors

Features

  • **Deploy Compute Resources**: Deploy compute resources using YAML configuration
  • **Fetch Wallet Balance**: Check your wallet balance for different tokens
  • **Fetch Deployment URLs**: Get URLs for your active deployments
  • **Fetch Lease ID Details**: Get detailed information about a lease

Installation

1. Clone the Repository

2. Set Up Node.js Version

Using nvm (recommended)

Without nvm

If you're not using nvm, ensure your system Node.js version is 16.0.0 or higher:

3. Install Dependencies and Build

The build process will:
  1. Compile TypeScript to JavaScript
  1. Make the main file executable
  1. Run the Node.js version check script

Configuration

VS Code Configuration

  1. Locate or create the MCP settings file:
  1. Edit the settings file with your configuration:
  1. Find the absolute path to the mcp-server directory:
  1. Add the following configuration (adjust paths and keys as needed):
  1. Or use the Docker configuration:
  1. Save the file and restart VS Code

Claude Desktop Configuration

  1. Locate or create the Claude Desktop configuration file:
  1. Edit the configuration file:
  1. Add the following configuration (adjust paths and keys as needed):

Docker Configuration

Node Configuration

Find the absolute path to the mcp-server directory:
Add the following configuration:
  1. Save the file and restart Claude Desktop

Cursor Configuration

  1. Locate or create the Cursor configuration file:
  1. Edit the configuration file:

Usage

Once installed, you can use the Spheron Protocol MCP plugin through Claude with commands like:

Deploy Compute

Or say:

Check Wallet Balance

Get Deployment URLs

Get Lease Details

Environment Variables

  • `SPHERON_PRIVATE_KEY`: Your Spheron private key for authentication
  • `SPHERON_NETWORK`: Network to use (testnet or mainnet)
  • `PROVIDER_PROXY_URL`: URL for the provider proxy server
  • `YAML_API_URL`: URL for the YAML generation API service

License

MIT