Skip to content

Commit 21dfe7a

Browse files
rodion-mclaude
andcommitted
Update Docker tags to :main and improve Claude Desktop install UX
- Replace all v0.3.0 Docker image tags with :main (no README updates needed per release) - Rewrite Claude Desktop section: .mcpb download from Releases first, Docker fallback second - Attach .mcpb bundle to GitHub Releases in release workflow Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 027917f commit 21dfe7a

2 files changed

Lines changed: 30 additions & 28 deletions

File tree

.github/workflows/release.yml

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -181,11 +181,21 @@ jobs:
181181
- name: Publish to MCP Registry
182182
run: ./mcp-publisher publish
183183

184+
- uses: actions/setup-node@v4
185+
with:
186+
node-version: '22'
187+
188+
- name: Build MCPB extension bundle
189+
run: |
190+
mkdir -p dist
191+
npx -y @anthropic-ai/mcpb pack . dist/codealive-mcp.mcpb
192+
184193
- name: Create GitHub Release
185194
uses: softprops/action-gh-release@153bb8e04406b158c6c84fc1615b65b24149a1fe # v2.6.1
186195
with:
187196
tag_name: v${{ steps.version.outputs.version }}
188197
name: CodeAlive MCP v${{ steps.version.outputs.version }}
198+
files: dist/codealive-mcp.mcpb
189199
body: |
190200
## CodeAlive MCP Server v${{ steps.version.outputs.version }}
191201

README.md

Lines changed: 20 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,7 @@ claude mcp add --transport http codealive https://mcp.codealive.ai/api --header
126126
**Option 2: Docker (STDIO)**
127127

128128
```bash
129-
claude mcp add codealive-docker /usr/bin/docker run --rm -i -e CODEALIVE_API_KEY=YOUR_API_KEY_HERE ghcr.io/codealive-ai/codealive-mcp:v0.3.0
129+
claude mcp add codealive-docker /usr/bin/docker run --rm -i -e CODEALIVE_API_KEY=YOUR_API_KEY_HERE ghcr.io/codealive-ai/codealive-mcp:main
130130
```
131131

132132
Replace `YOUR_API_KEY_HERE` with your actual API key.
@@ -168,7 +168,7 @@ Replace `YOUR_API_KEY_HERE` with your actual API key.
168168
"args": [
169169
"run", "--rm", "-i",
170170
"-e", "CODEALIVE_API_KEY=YOUR_API_KEY_HERE",
171-
"ghcr.io/codealive-ai/codealive-mcp:v0.3.0"
171+
"ghcr.io/codealive-ai/codealive-mcp:main"
172172
]
173173
}
174174
}
@@ -188,7 +188,7 @@ OpenAI Codex CLI supports MCP via `~/.codex/config.toml`.
188188
command = "docker"
189189
args = ["run", "--rm", "-i",
190190
"-e", "CODEALIVE_API_KEY=YOUR_API_KEY_HERE",
191-
"ghcr.io/codealive-ai/codealive-mcp:v0.3.0"]
191+
"ghcr.io/codealive-ai/codealive-mcp:main"]
192192
```
193193

194194
**Experimental: Streamable HTTP (requires `[features].rmcp_client = true`)**
@@ -249,7 +249,7 @@ mcpServers:
249249
- -i
250250
- -e
251251
- CODEALIVE_API_KEY=YOUR_API_KEY_HERE
252-
- ghcr.io/codealive-ai/codealive-mcp:v0.3.0
252+
- ghcr.io/codealive-ai/codealive-mcp:main
253253
```
254254
255255
</details>
@@ -294,7 +294,7 @@ Create `.vscode/mcp.json` in your workspace:
294294
"args": [
295295
"run", "--rm", "-i",
296296
"-e", "CODEALIVE_API_KEY=YOUR_API_KEY_HERE",
297-
"ghcr.io/codealive-ai/codealive-mcp:v0.3.0"
297+
"ghcr.io/codealive-ai/codealive-mcp:main"
298298
]
299299
}
300300
}
@@ -306,26 +306,18 @@ Create `.vscode/mcp.json` in your workspace:
306306
<details>
307307
<summary><b>Claude Desktop</b></summary>
308308

309-
> **Recommended:** use the native Claude Desktop extension bundle (`.mcpb`) for one-click install, secure token storage, and self-hosted `baseUrl` configuration. Keep Docker (STDIO) as a fallback.
309+
**Option 1: Extension bundle `.mcpb` (Recommended)**
310310

311-
**Native desktop extension (`.mcpb`)**
312-
313-
1. Build the bundle from this repository:
314-
```bash
315-
npm install -g @anthropic-ai/mcpb
316-
mcpb pack
317-
```
311+
The `.mcpb` bundle gives you one-click install, secure token storage, and self-hosted `baseUrl` configuration — no Docker or CLI required.
318312

313+
1. Download `codealive-mcp.mcpb` from the [latest GitHub Release](https://github.com/CodeAlive-AI/codealive-mcp/releases/latest)
319314
2. In Claude Desktop, open **Settings → Extensions → Install Extension...**
320-
321-
3. Select the generated `.mcpb` file and configure:
315+
3. Select the downloaded `.mcpb` file and configure:
322316
- **CodeAlive API Key**: your bearer token
323-
- **CodeAlive Base URL**: your deployment origin, for example `https://codealive.yourcompany.com`
317+
- **CodeAlive Base URL**: defaults to `https://app.codealive.ai`; for self-hosted, use your deployment origin (e.g. `https://codealive.yourcompany.com`)
324318
- **Ignore TLS Errors**: only for dev/self-signed environments
325319

326-
`https://host` is preferred. `https://host/api` is also accepted and normalized automatically.
327-
328-
**Docker (STDIO) fallback**
320+
**Option 2: Docker (STDIO)**
329321

330322
1. Edit your config file:
331323
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
@@ -341,7 +333,7 @@ Create `.vscode/mcp.json` in your workspace:
341333
"args": [
342334
"run", "--rm", "-i",
343335
"-e", "CODEALIVE_API_KEY=YOUR_API_KEY_HERE",
344-
"ghcr.io/codealive-ai/codealive-mcp:v0.3.0"
336+
"ghcr.io/codealive-ai/codealive-mcp:main"
345337
]
346338
}
347339
}
@@ -386,7 +378,7 @@ Create `.vscode/mcp.json` in your workspace:
386378
"args": [
387379
"run", "--rm", "-i",
388380
"-e", "CODEALIVE_API_KEY=YOUR_API_KEY_HERE",
389-
"ghcr.io/codealive-ai/codealive-mcp:v0.3.0"
381+
"ghcr.io/codealive-ai/codealive-mcp:main"
390382
]
391383
}
392384
}
@@ -449,7 +441,7 @@ Qwen Code supports MCP via `mcpServers` in its `settings.json` and multiple tran
449441
"command": "docker",
450442
"args": ["run", "--rm", "-i",
451443
"-e", "CODEALIVE_API_KEY=YOUR_API_KEY_HERE",
452-
"ghcr.io/codealive-ai/codealive-mcp:v0.3.0"]
444+
"ghcr.io/codealive-ai/codealive-mcp:main"]
453445
}
454446
}
455447
}
@@ -489,7 +481,7 @@ Roo Code reads a JSON settings file similar to Cline.
489481
"args": [
490482
"run", "--rm", "-i",
491483
"-e", "CODEALIVE_API_KEY=YOUR_API_KEY_HERE",
492-
"ghcr.io/codealive-ai/codealive-mcp:v0.3.0"
484+
"ghcr.io/codealive-ai/codealive-mcp:main"
493485
]
494486
}
495487
}
@@ -514,7 +506,7 @@ Roo Code reads a JSON settings file similar to Cline.
514506

515507
Add a STDIO extension with:
516508
- **Command:** `docker`
517-
- **Args:** `run --rm -i -e CODEALIVE_API_KEY=YOUR_API_KEY_HERE ghcr.io/codealive-ai/codealive-mcp:v0.3.0`
509+
- **Args:** `run --rm -i -e CODEALIVE_API_KEY=YOUR_API_KEY_HERE ghcr.io/codealive-ai/codealive-mcp:main`
518510

519511
</details>
520512

@@ -548,7 +540,7 @@ Add a STDIO extension with:
548540
"args": [
549541
"run", "--rm", "-i",
550542
"-e", "CODEALIVE_API_KEY=YOUR_API_KEY_HERE",
551-
"ghcr.io/codealive-ai/codealive-mcp:v0.3.0"
543+
"ghcr.io/codealive-ai/codealive-mcp:main"
552544
]
553545
}
554546
}
@@ -624,7 +616,7 @@ npm install -g mcp-remote
624616
"args": [
625617
"run", "--rm", "-i",
626618
"-e", "CODEALIVE_API_KEY=YOUR_API_KEY_HERE",
627-
"ghcr.io/codealive-ai/codealive-mcp:v0.3.0"
619+
"ghcr.io/codealive-ai/codealive-mcp:main"
628620
]
629621
}
630622
}
@@ -663,7 +655,7 @@ npm install -g mcp-remote
663655
"args": [
664656
"run", "--rm", "-i",
665657
"-e", "CODEALIVE_API_KEY=YOUR_API_KEY_HERE",
666-
"ghcr.io/codealive-ai/codealive-mcp:v0.3.0"
658+
"ghcr.io/codealive-ai/codealive-mcp:main"
667659
]
668660
}
669661
}
@@ -704,7 +696,7 @@ npm install -g mcp-remote
704696
"args": [
705697
"run", "--rm", "-i",
706698
"-e", "CODEALIVE_API_KEY=YOUR_API_KEY_HERE",
707-
"ghcr.io/codealive-ai/codealive-mcp:v0.3.0"
699+
"ghcr.io/codealive-ai/codealive-mcp:main"
708700
]
709701
}
710702
}

0 commit comments

Comments
 (0)