4EVERLAND Hosting MCP Server

1# 4EVERLAND Hosting MCP Server
2 
3[![Version](https://img.shields.io/badge/version-0.1.4-blue.svg)](https://www.npmjs.com/package/@4everland/hosting-mcp)
4[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5[![Node](https://img.shields.io/badge/node-%3E%3D20.12.2-green.svg)](https://nodejs.org/)
6 
7---
8 
9A Model Context Protocol (MCP) server implementation
10for [4EVERLAND Hosting](https://docs.4everland.org/hositng/what-is-hosting) enabling instant deployment of AI-generated
11code to decentralized storage networks like Greenfield, IPFS, and Arweave.
12 
13## Overview
14 
15The 4EVERLAND Hosting MCP Server enables users to leverage AI-driven workflows to deploy code instantly to decentralized
16storage networks such as Greenfield, IPFS, and Arweave. Upon deployment, it provides a directly accessible webpage
17domain, streamlining the process of deploying and sharing decentralized applications.
18 
19## Features
20 
21- **Instant Deployment with Domain Generation**: Deploy AI-generated code to decentralized storage networks and receive
22  a unique, immediately accessible webpage domain with a single command.
23- **Multiple Decentralized Storage Networks**: Support for Greenfield, IPFS, and Arweave, enabling flexible and
24  resilient storage options for your applications.
25- **Secure and Loss-Proof Decentralized Storage**: Leverage the robust, tamper-resistant, and highly available nature of
26  decentralized storage to ensure data security and prevent data loss.
27- **Visual Project Management Interface**: Manage your deployed projects, view detailed information, or configure custom
28  domains directly in the [4EVERLAND Dashboard](https://dashboard.4everland.org/).
29 
30## MCP Tool
31 
32### Tool: deploy_site
33 
34**Description**: Deploys code to 4EVERLAND hosting platforms.
35 
36| Parameter    | Type                         | Description                                                                   |
37|--------------|------------------------------|-------------------------------------------------------------------------------|
38| code_files   | Record<string, string> | Map of file paths to their content                                            |
39| project_name | string                       | Project name (alphanumeric, underscore, hyphen; cannot start/end with hyphen) |
40| project_id   | string (optional)            | Existing project ID to deploy to (new project created if omitted)             |
41| platform     | "IPFS"\|"AR"\|"GREENFIELD"   | Storage platform to deploy to (default: `"IPFS"`)                             |
42 
43## Get Hosting Auth Token
44 
451. Log in to your [4EVERLAND Dashboard](https://dashboard.4everland.org/) account.
462. Go to **Hosting** -> **Auth Token**.
473. Click on **+Create** to generate a new token.
484. Copy and save the token somewhere safe as it will only be shown once.
49 
50## Integration with Cursor
51 
52To connect to the MCP server from Cursor:
53 
541. Open Cursor and go to **Settings** (gear icon in the top right).
552. Click on **MCP** in the left sidebar.
563. Click **Add new global MCP server**.
574. Enter the following details:
58 
59```json
60{
61  "mcpServers": {
62    "4ever-mcpserver": {
63      "command": "npx",
64      "args": [
65        "-y",
66        "@4everland/hosting-mcp@latest",
67        "serve"
68      ],
69      "env": {
70        "TOKEN": "your-hosting-auth-token"
71      }
72    }
73  }
74}
75```
76 
77## Integration with Claude Desktop
78 
79To connect to the MCP server from Claude Desktop:
80 
811. Open Claude Desktop and go to **Settings**.
822. Click on **Developer** in the left sidebar.
833. Click the **Edit Config** button.
844. Add the following configuration to the `claude_desktop_config.json` file:
85 
86```json
87{
88  "mcpServers": {
89    "4ever-mcpserver": {
90      "command": "npx",
91      "args": [
92        "-y",
93        "@4everland/hosting-mcp@latest",
94        "serve"
95      ],
96      "env": {
97        "TOKEN": "your-hosting-auth-token"
98      }
99    }
100  }
101}
102```
103 
1045. Save the file and restart Claude Desktop.
105 
106## Local Development
107 
108To run the server locally for development:
109 
110```bash
111# Clone repository
112git clone https://github.com/4everland/4everland-hosting-mcp.git
113cd 4everland-hosting-mcp
114 
115# Install dependencies
116npm install
117 
118# Build the project
119npm run build
120 
121# Run the server locally
122npm run serve
123```
124 
125## License
126 
127This project is licensed under the MIT License.