Skip to content

Commit ff58734

Browse files
docs: use @latest tag in uvx config for auto-updates (#306)
* docs: use @latest tag in uvx config for auto-updates Without @latest, uvx caches the first downloaded version forever. Adding @latest ensures uvx checks PyPI on each client launch and pulls new versions automatically. * docs: apply @latest consistently to all uvx invocations Update --login examples in README.md and docs/docker-hub.md to use linkedin-scraper-mcp@latest for consistency with the MCP config. --------- Co-authored-by: Daniel Sticker <sticker@ngenn.net>
1 parent 36fc9b0 commit ff58734

2 files changed

Lines changed: 12 additions & 12 deletions

File tree

README.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -73,17 +73,17 @@ What has Anthropic been posting about recently? https://www.linkedin.com/company
7373
"mcpServers": {
7474
"linkedin": {
7575
"command": "uvx",
76-
"args": ["linkedin-scraper-mcp"],
76+
"args": ["linkedin-scraper-mcp@latest"],
7777
"env": { "UV_HTTP_TIMEOUT": "300" }
7878
}
7979
}
8080
}
8181
```
8282

83-
The server starts quickly, prepares the shared Patchright Chromium browser cache in the background under `~/.linkedin-mcp/patchright-browsers`, and opens a LinkedIn login browser window on the first tool call that needs authentication.
83+
The `@latest` tag ensures you always run the newest version — `uvx` checks PyPI on each client launch and updates automatically. The server starts quickly, prepares the shared Patchright Chromium browser cache in the background under `~/.linkedin-mcp/patchright-browsers`, and opens a LinkedIn login browser window on the first tool call that needs authentication.
8484

8585
> [!NOTE]
86-
> Early tool calls may return a setup/authentication-in-progress error until browser setup or login finishes. If you prefer to create a session explicitly, run `uvx linkedin-scraper-mcp --login`.
86+
> Early tool calls may return a setup/authentication-in-progress error until browser setup or login finishes. If you prefer to create a session explicitly, run `uvx linkedin-scraper-mcp@latest --login`.
8787
8888
### uvx Setup Help
8989

@@ -115,13 +115,13 @@ The server starts quickly, prepares the shared Patchright Chromium browser cache
115115

116116
```bash
117117
# Run with debug logging
118-
uvx linkedin-scraper-mcp --log-level DEBUG
118+
uvx linkedin-scraper-mcp@latest --log-level DEBUG
119119
```
120120

121121
**HTTP Mode Example (for web-based MCP clients):**
122122

123123
```bash
124-
uvx linkedin-scraper-mcp --transport streamable-http --host 127.0.0.1 --port 8080 --path /mcp
124+
uvx linkedin-scraper-mcp@latest --transport streamable-http --host 127.0.0.1 --port 8080 --path /mcp
125125
```
126126

127127
Runtime server logs are emitted by FastMCP/Uvicorn.
@@ -159,7 +159,7 @@ parallel. Use `--log-level DEBUG` to see scraper lock wait/acquire/release logs.
159159
**Login issues:**
160160

161161
- LinkedIn may require a login confirmation in the LinkedIn mobile app for `--login`
162-
- You might get a captcha challenge if you logged in frequently. Run `uvx linkedin-scraper-mcp --login` which opens a browser where you can solve it manually.
162+
- You might get a captcha challenge if you logged in frequently. Run `uvx linkedin-scraper-mcp@latest --login` which opens a browser where you can solve it manually.
163163

164164
**Timeout issues:**
165165

@@ -204,7 +204,7 @@ On startup, the MCP Bundle starts preparing the shared Patchright Chromium brows
204204

205205
- Make sure you have only one active LinkedIn session at a time
206206
- LinkedIn may require a login confirmation in the LinkedIn mobile app for `--login`
207-
- You might get a captcha challenge if you logged in frequently. Run `uvx linkedin-scraper-mcp --login` which opens a browser where you can solve captchas manually. See the [uvx setup](#-uvx-setup-recommended---universal) for prerequisites.
207+
- You might get a captcha challenge if you logged in frequently. Run `uvx linkedin-scraper-mcp@latest --login` which opens a browser where you can solve captchas manually. See the [uvx setup](#-uvx-setup-recommended---universal) for prerequisites.
208208

209209
**Timeout issues:**
210210

@@ -228,7 +228,7 @@ Docker runs headless (no browser window), so you need to create a browser profil
228228
**Step 1: Create profile on the host (one-time setup)**
229229

230230
```bash
231-
uvx linkedin-scraper-mcp --login
231+
uvx linkedin-scraper-mcp@latest --login
232232
```
233233

234234
This opens a browser window where you log in manually (5 minute timeout for 2FA, captcha, etc.). The browser profile and cookies are saved under `~/.linkedin-mcp/`. On startup, Docker derives a Linux browser profile from your host cookies and creates a fresh session each time. If you experience stability issues with Docker, consider using the [uvx setup](#-uvx-setup-recommended---universal) instead.
@@ -251,7 +251,7 @@ This opens a browser window where you log in manually (5 minute timeout for 2FA,
251251
```
252252

253253
> [!NOTE]
254-
> Docker creates a fresh session on each startup. Sessions may expire over time — run `uvx linkedin-scraper-mcp --login` again if you encounter authentication issues.
254+
> Docker creates a fresh session on each startup. Sessions may expire over time — run `uvx linkedin-scraper-mcp@latest --login` again if you encounter authentication issues.
255255
256256
> [!NOTE]
257257
> **Why can't I run `--login` in Docker?** Docker containers don't have a display server. Create a profile on your host using the [uvx setup](#-uvx-setup-recommended---universal) and mount it into Docker.
@@ -318,7 +318,7 @@ Runtime server logs are emitted by FastMCP/Uvicorn.
318318

319319
- Make sure you have only one active LinkedIn session at a time
320320
- LinkedIn may require a login confirmation in the LinkedIn mobile app for `--login`
321-
- You might get a captcha challenge if you logged in frequently. Run `uvx linkedin-scraper-mcp --login` which opens a browser where you can solve captchas manually. See the [uvx setup](#-uvx-setup-recommended---universal) for prerequisites.
321+
- You might get a captcha challenge if you logged in frequently. Run `uvx linkedin-scraper-mcp@latest --login` which opens a browser where you can solve captchas manually. See the [uvx setup](#-uvx-setup-recommended---universal) for prerequisites.
322322
- If Docker auth becomes stale after you re-login on the host, restart Docker once so it can fresh-bridge from the new source session generation.
323323

324324
**Timeout issues:**

docs/docker-hub.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,12 +16,12 @@ A Model Context Protocol (MCP) server that connects AI assistants to LinkedIn. A
1616

1717
## Quick Start
1818

19-
Create a browser profile locally, then mount it into Docker. You still need [uv](https://docs.astral.sh/uv/getting-started/installation/) installed on the host for the one-time `uvx linkedin-scraper-mcp --login` step. Docker already includes its own Chromium runtime, so the managed Patchright Chromium browser download used by MCPB/`uvx` is not needed here.
19+
Create a browser profile locally, then mount it into Docker. You still need [uv](https://docs.astral.sh/uv/getting-started/installation/) installed on the host for the one-time `uvx linkedin-scraper-mcp@latest --login` step. Docker already includes its own Chromium runtime, so the managed Patchright Chromium browser download used by MCPB/`uvx` is not needed here.
2020

2121
**Step 1: Create profile on the host (one-time setup)**
2222

2323
```bash
24-
uvx linkedin-scraper-mcp --login
24+
uvx linkedin-scraper-mcp@latest --login
2525
```
2626

2727
This opens a browser window where you log in manually (5 minute timeout for 2FA, captcha, etc.). The browser profile and cookies are saved under `~/.linkedin-mcp/`. On startup, Docker derives a Linux browser profile from your host cookies and creates a fresh session each time. For better stability, consider the [uvx setup](https://github.com/stickerdaniel/linkedin-mcp-server#-uvx-setup-recommended---universal).

0 commit comments

Comments
 (0)