@eternalai-org/mcp-server 1.0.6 → 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +200 -44
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Eternal AI MCP Server
2
2
 
3
- A Model Context Protocol (MCP) server for Eternal AI that provides tools for image generation, image editing, and video generation.
3
+ The Eternal AI Model Context Protocol (MCP) server provides tools for image generation, image editing, and video generation.
4
4
 
5
5
  ## Features
6
6
 
@@ -15,7 +15,7 @@ A Model Context Protocol (MCP) server for Eternal AI that provides tools for ima
15
15
  - **ETERNAL_AI_API_KEY** (required): Your API key from [eternalai.org/api/keys](https://eternalai.org/api/keys).
16
16
  - **SAVE_FILE_PATH** (optional): Directory or file path where generated files should be saved. If not set, files are saved to the current working directory.
17
17
 
18
- ### Example
18
+ ### Testing with MCP Inspector
19
19
 
20
20
  ```bash
21
21
  npx @modelcontextprotocol/inspector -e ETERNAL_AI_API_KEY=your_api_key_here npx @eternalai-org/mcp-server@latest
@@ -23,22 +23,14 @@ npx @modelcontextprotocol/inspector -e ETERNAL_AI_API_KEY=your_api_key_here npx
23
23
 
24
24
  ## Usage with MCP Clients
25
25
 
26
- ### Claude Desktop
27
-
28
- Add the following to your Claude Desktop configuration file:
29
-
30
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
31
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
26
+ Add the following config to your MCP client:
32
27
 
33
28
  ```json
34
29
  {
35
30
  "mcpServers": {
36
31
  "eternal-ai": {
37
32
  "command": "npx",
38
- "args": [
39
- "-y",
40
- "@eternalai-org/mcp-server@latest"
41
- ],
33
+ "args": ["-y", "@eternalai-org/mcp-server@latest"],
42
34
  "env": {
43
35
  "ETERNAL_AI_API_KEY": "your_api_key_here"
44
36
  }
@@ -47,44 +39,171 @@ Add the following to your Claude Desktop configuration file:
47
39
  }
48
40
  ```
49
41
 
50
- ### Cursor
42
+ > [!NOTE]
43
+ > Using `@eternalai-org/mcp-server@latest` ensures that your MCP client will always use the latest version of the Eternal AI MCP server.
51
44
 
52
- Add to your Cursor MCP settings (Settings → Features → MCP):
45
+ ### MCP Client configuration
53
46
 
54
- ```json
55
- {
56
- "mcpServers": {
57
- "eternal-ai": {
58
- "command": "npx",
59
- "args": [
60
- "-y",
61
- "@eternalai-org/mcp-server@latest"
62
- ],
63
- "env": {
64
- "ETERNAL_AI_API_KEY": "your_api_key_here"
65
- }
66
- }
67
- }
68
- }
47
+ <details>
48
+ <summary>Antigravity</summary>
49
+
50
+ To use the Eternal AI MCP server follow the instructions from [Antigravity's docs](https://antigravity.google/docs/mcp) to install a custom MCP server. Use the config provided above.
51
+
52
+ </details>
53
+
54
+ <details>
55
+ <summary>Claude Code</summary>
56
+
57
+ Use the Claude Code CLI to add the Eternal AI MCP server ([guide](https://code.claude.com/docs/en/mcp)):
58
+
59
+ ```bash
60
+ claude mcp add eternal-ai --scope user -- npx @eternalai-org/mcp-server@latest -e ETERNAL_AI_API_KEY=your_api_key_here
69
61
  ```
70
62
 
71
- ### Claude Code
63
+ </details>
64
+
65
+ <details>
66
+ <summary>Cline</summary>
67
+
68
+ Follow [https://docs.cline.bot/mcp/configuring-mcp-servers](https://docs.cline.bot/mcp/configuring-mcp-servers) and use the config provided above.
69
+
70
+ </details>
71
+
72
+ <details>
73
+ <summary>Codex</summary>
74
+
75
+ Follow the [configure MCP guide](https://developers.openai.com/codex/mcp/) using the standard config from above. You can also install the Eternal AI MCP server using the Codex CLI:
76
+
77
+ ```bash
78
+ codex mcp add eternal-ai --env ETERNAL_AI_API_KEY=your_api_key_here -- npx @eternalai-org/mcp-server@latest
79
+ ```
80
+
81
+ </details>
82
+
83
+ <details>
84
+ <summary>Copilot CLI</summary>
85
+
86
+ Start Copilot CLI:
87
+
88
+ ```bash
89
+ copilot
90
+ ```
91
+
92
+ Start the dialog to add a new MCP server by running:
93
+
94
+ ```bash
95
+ /mcp add
96
+ ```
97
+
98
+ Configure the following fields and press `CTRL+S` to save the configuration:
99
+
100
+ - **Server name:** `eternal-ai`
101
+ - **Server Type:** `[1] Local`
102
+ - **Command:** `npx -y @eternalai-org/mcp-server@latest`
103
+ - **Environment variables:** `ETERNAL_AI_API_KEY=your_api_key_here`
104
+
105
+ </details>
106
+
107
+ <details>
108
+ <summary>Copilot / VS Code</summary>
109
+
110
+ **Click the button to install:**
111
+
112
+ [![Install in VS Code](https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF)](https://vscode.dev/redirect/mcp/install?name=eternalai-org%2Feternal-ai&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40eternalai-org%2Fmcp-server%40latest%22%5D%2C%22env%22%3A%7B%22ETERNAL_AI_API_KEY%22%3A%22your_api_key_here%22%7D%7D)
113
+ [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5)](https://insiders.vscode.dev/redirect/mcp/install?name=eternalai-org%2Feternal-ai&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40eternalai-org%2Fmcp-server%40latest%22%5D%2C%22env%22%3A%7B%22ETERNAL_AI_API_KEY%22%3A%22your_api_key_here%22%7D%7D)
114
+
115
+ **Or install manually:**
116
+
117
+ Follow the MCP install [guide](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server), with the standard config from above. You can also install using the VS Code CLI:
118
+
119
+ ```bash
120
+ code --add-mcp '{"name":"eternalai-org/eternal-ai","command":"npx","args":["-y","@eternalai-org/mcp-server@latest"],"env":{"ETERNAL_AI_API_KEY":"your_api_key_here"}}'
121
+ ```
122
+
123
+ </details>
124
+
125
+ <details>
126
+ <summary>Cursor</summary>
127
+
128
+ **Click the button to install:**
129
+
130
+ [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=eternal-ai&config=eyJjb21tYW5kIjoibnB4IC15IEBldGVybmFsYWktb3JnL21jcC1zZXJ2ZXJAbGF0ZXN0IiwiZW52Ijp7IkVURVJOQUxfQUlfQVBJX0tFWSI6InlvdXJfYXBpX2tleV9oZXJlIn19)
131
+
132
+ **Or install manually:**
72
133
 
73
- Add to your Claude Code MCP settings:
134
+ Go to `Cursor Settings` -> `MCP` -> `New MCP Server`. Use the config provided above.
74
135
 
75
- 1. Open Claude Code settings
76
- 2. Navigate to MCP configuration
77
- 3. Add the following configuration:
136
+ </details>
137
+
138
+ <details>
139
+ <summary>Factory CLI</summary>
140
+
141
+ Use the Factory CLI to add the Eternal AI MCP server ([guide](https://docs.factory.ai/cli/configuration/mcp)):
142
+
143
+ ```bash
144
+ droid mcp add eternal-ai "npx -y @eternalai-org/mcp-server@latest"
145
+ ```
146
+
147
+ </details>
148
+
149
+ <details>
150
+ <summary>Gemini CLI</summary>
151
+
152
+ Install the Eternal AI MCP server using the Gemini CLI.
153
+
154
+ **Project wide:**
155
+
156
+ ```bash
157
+ gemini mcp add eternal-ai npx @eternalai-org/mcp-server@latest
158
+ ```
159
+
160
+ **Globally:**
161
+
162
+ ```bash
163
+ gemini mcp add -s user eternal-ai npx @eternalai-org/mcp-server@latest
164
+ ```
165
+
166
+ Alternatively, follow the [MCP guide](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md#how-to-set-up-your-mcp-server) and use the standard config from above.
167
+
168
+ </details>
169
+
170
+ <details>
171
+ <summary>Gemini Code Assist</summary>
172
+
173
+ Follow the [configure MCP guide](https://cloud.google.com/gemini/docs/codeassist/use-agentic-chat-pair-programmer#configure-mcp-servers) using the standard config from above.
174
+
175
+ </details>
176
+
177
+ <details>
178
+ <summary>JetBrains AI Assistant & Junie</summary>
179
+
180
+ Go to `Settings | Tools | AI Assistant | Model Context Protocol (MCP)` -> `Add`. Use the config provided above.
181
+
182
+ The same way eternal-ai can be configured for JetBrains Junie in `Settings | Tools | Junie | MCP Settings` -> `Add`. Use the config provided above.
183
+
184
+ </details>
185
+
186
+ <details>
187
+ <summary>Kiro</summary>
188
+
189
+ In **Kiro Settings**, go to `Configure MCP` > `Open Workspace or User MCP Config` > Use the configuration snippet provided above.
190
+
191
+ Or, from the IDE **Activity Bar** > `Kiro` > `MCP Servers` > `Click Open MCP Config`. Use the configuration snippet provided above.
192
+
193
+ </details>
194
+
195
+ <details>
196
+ <summary>OpenCode</summary>
197
+
198
+ Add the following configuration to your `opencode.json` file. If you don't have one, create it at `~/.config/opencode/opencode.json` ([guide](https://opencode.ai/docs/mcp-servers)):
78
199
 
79
200
  ```json
80
201
  {
81
- "mcpServers": {
202
+ "$schema": "https://opencode.ai/config.json",
203
+ "mcp": {
82
204
  "eternal-ai": {
83
- "command": "npx",
84
- "args": [
85
- "-y",
86
- "@eternalai-org/mcp-server@latest"
87
- ],
205
+ "type": "local",
206
+ "command": ["npx", "-y", "@eternalai-org/mcp-server@latest"],
88
207
  "env": {
89
208
  "ETERNAL_AI_API_KEY": "your_api_key_here"
90
209
  }
@@ -93,7 +212,44 @@ Add to your Claude Code MCP settings:
93
212
  }
94
213
  ```
95
214
 
96
- Restart Claude Code after adding the configuration.
215
+ </details>
216
+
217
+ <details>
218
+ <summary>Qoder</summary>
219
+
220
+ In **Qoder Settings**, go to `MCP Server` > `+ Add` > Use the configuration snippet provided above.
221
+
222
+ Alternatively, follow the [MCP guide](https://docs.qoder.com/user-guide/chat/model-context-protocol) and use the standard config from above.
223
+
224
+ </details>
225
+
226
+ <details>
227
+ <summary>Qoder CLI</summary>
228
+
229
+ Install the Eternal AI MCP server using the Qoder CLI ([guide](https://docs.qoder.com/cli/using-cli#mcp-servsers)):
230
+
231
+ **Project wide:**
232
+
233
+ ```bash
234
+ qodercli mcp add eternal-ai -- npx @eternalai-org/mcp-server@latest
235
+ ```
236
+
237
+ **Globally:**
238
+
239
+ ```bash
240
+ qodercli mcp add -s user eternal-ai -- npx @eternalai-org/mcp-server@latest
241
+ ```
242
+
243
+ </details>
244
+
245
+ <details>
246
+ <summary>Visual Studio</summary>
247
+
248
+ **Click the button to install:**
249
+
250
+ [![Install in Visual Studio](https://img.shields.io/badge/Visual_Studio-Install-C16FDE?logo=visualstudio&logoColor=white)](<https://vs-open.link/mcp-install?{"name":"eternal-ai","command":"npx","args":["-y","@eternalai-org/mcp-server@latest"],"env":{"ETERNAL_AI_API_KEY":"your_api_key_here"}}>)
251
+
252
+ </details>
97
253
 
98
254
  ## Available Tools
99
255
 
@@ -107,10 +263,10 @@ Generate an image from a text prompt.
107
263
  ```json
108
264
  {
109
265
  "Art_style_Impressionist": 1,
110
- "psycho_art": 0.8,
266
+ "psycho_art": 1,
111
267
  "FLUX-daubrez-DB4RZ": 1,
112
- "Flux_1_MechanicalBloom": 0.5,
113
- "RM_Artistify_v1_0M": 0.7
268
+ "Flux_1_MechanicalBloom": 1,
269
+ "RM_Artistify_v1_0M": 1
114
270
  }
115
271
  ```
116
272
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@eternalai-org/mcp-server",
3
- "version": "1.0.6",
3
+ "version": "1.0.7",
4
4
  "description": "MCP server for Eternal AI image generation, editing, and video generation",
5
5
  "main": "dist/index.js",
6
6
  "bin": {