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:
Compile TypeScript to JavaScript
Make the main file executable
Run the Node.js version check script
Configuration
VS Code Configuration
Locate or create the MCP settings file:
Edit the settings file with your configuration:
Find the absolute path to the mcp-server directory:
Add the following configuration (adjust paths and keys as needed):
Or use the Docker configuration:
Save the file and restart VS Code
Claude Desktop Configuration
Locate or create the Claude Desktop configuration file:
Edit the configuration file:
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:
Save the file and restart Claude Desktop
Cursor Configuration
Locate or create the Cursor configuration file:
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