4EVERLAND Hosting MCP Server

A Model Context Protocol (MCP) server implementation for 4EVERLAND Hosting enabling instant deployment of AI-generated code to decentralized storage networks like Greenfield, IPFS, and Arweave.

Overview

The 4EVERLAND Hosting MCP Server enables users to leverage AI-driven workflows to deploy code instantly to decentralized storage networks such as Greenfield, IPFS, and Arweave. Upon deployment, it provides a directly accessible webpage domain, streamlining the process of deploying and sharing decentralized applications.

Features

Instant Deployment with Domain Generation: Deploy AI-generated code to decentralized storage networks and receive a unique, immediately accessible webpage domain with a single command.
Multiple Decentralized Storage Networks: Support for Greenfield, IPFS, and Arweave, enabling flexible and resilient storage options for your applications.
Secure and Loss-Proof Decentralized Storage: Leverage the robust, tamper-resistant, and highly available nature of decentralized storage to ensure data security and prevent data loss.
Visual Project Management Interface: Manage your deployed projects, view detailed information, or configure custom domains directly in the 4EVERLAND Dashboard.

MCP Tool

Tool: deploy_site

Description: Deploys code to 4EVERLAND hosting platforms.

Parameter	Type	Description
code_files	Record<string, string>	Map of file paths to their content
project_name	string	Project name (alphanumeric, underscore, hyphen; cannot start/end with hyphen)
project_id	string (optional)	Existing project ID to deploy to (new project created if omitted)
platform	"IPFS"\|"AR"\|"GREENFIELD"	Storage platform to deploy to (default: `"IPFS"`)

Get Hosting Auth Token

Log in to your 4EVERLAND Dashboard account.
Go to Hosting -> Auth Token.
Click on +Create to generate a new token.
Copy and save the token somewhere safe as it will only be shown once.

Integration with Cursor

To connect to the MCP server from Cursor:

Open Cursor and go to Settings (gear icon in the top right).
Click on MCP in the left sidebar.
Click Add new global MCP server.
Enter the following details:

{
  "mcpServers": {
    "4ever-mcpserver": {
      "command": "npx",
      "args": [
        "-y",
        "@4everland/hosting-mcp@latest",
        "serve"
      ],
      "env": {
        "TOKEN": "your-hosting-auth-token"
      }
    }
  }
}

Integration with Claude Desktop

To connect to the MCP server from Claude Desktop:

Open Claude Desktop and go to Settings.
Click on Developer in the left sidebar.
Click the Edit Config button.
Add the following configuration to the claude_desktop_config.json file:

{
  "mcpServers": {
    "4ever-mcpserver": {
      "command": "npx",
      "args": [
        "-y",
        "@4everland/hosting-mcp@latest",
        "serve"
      ],
      "env": {
        "TOKEN": "your-hosting-auth-token"
      }
    }
  }
}

Save the file and restart Claude Desktop.

Local Development

To run the server locally for development:

# Clone repository
git clone https://github.com/4everland/4everland-hosting-mcp.git
cd 4everland-hosting-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run the server locally
npm run serve

License

This project is licensed under the MIT License.