@contextstream/mcp-server 0.4.66 → 0.4.68

package/README.md

@@ -24,7 +24,7 @@
 <div align="center">
 
 ```bash
-npx @contextstream/mcp-server@latest setup
+npx --prefer-online -y @contextstream/mcp-server@latest setup
 ```
 
 </div>
@@ -35,6 +35,36 @@ npx @contextstream/mcp-server@latest setup
 
 ---
 
+## Get Started (VS Code + Copilot)
+
+### Option 1: Rust MCP (recommended)
+
+```bash
+curl -fsSL https://contextstream.io/scripts/mcp.sh | bash
+```
+
+```powershell
+irm https://contextstream.io/scripts/mcp.ps1 | iex
+```
+
+Then run:
+
+```bash
+contextstream-mcp setup
+```
+
+### Option 2: Node MCP
+
+```bash
+npx --prefer-online -y @contextstream/mcp-server@latest setup
+```
+
+After setup, restart VS Code/Copilot.
+
+**Works with:** Claude Code • Cursor • VS Code • Claude Desktop • Codex CLI • OpenCode • Antigravity
+
+---
+
 ## This Isn't Just Memory. This Is Intelligence.
 
 Other tools give your AI a notepad. **ContextStream gives it a brain.**
@@ -76,18 +106,6 @@ Long conversation? ContextStream tracks token usage, auto-saves critical state,
 
 ---
 
-## Setup Takes 30 Seconds
-
-```bash
-npx @contextstream/mcp-server@latest setup
-```
-
-The wizard handles everything: authentication, configuration, editor integration, and optional hooks that supercharge your workflow.
-
-**Works with:** Claude Code • Cursor • VS Code • Claude Desktop • Codex CLI • OpenCode • Antigravity
-
----
-
 ## The Tools Your AI Gets
 
 ```
@@ -114,8 +132,8 @@ Your AI uses these automatically. You just code.
 <summary><b>Claude Code</b></summary>
 
 ```bash
-claude mcp add contextstream -- npx @contextstream/mcp-server
-claude mcp update contextstream -e CONTEXTSTREAM_API_KEY=your_key
+claude mcp add contextstream -- npx --prefer-online -y @contextstream/mcp-server@latest
+claude mcp update contextstream -e CONTEXTSTREAM_API_URL=https://api.contextstream.io -e CONTEXTSTREAM_API_KEY=your_key
 ```
 
 </details>
@@ -128,8 +146,11 @@ claude mcp update contextstream -e CONTEXTSTREAM_API_KEY=your_key
   "mcpServers": {
     "contextstream": {
       "command": "npx",
-      "args": ["-y", "@contextstream/mcp-server"],
-      "env": { "CONTEXTSTREAM_API_KEY": "your_key" }
+      "args": ["--prefer-online", "-y", "@contextstream/mcp-server@latest"],
+      "env": {
+        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
+        "CONTEXTSTREAM_API_KEY": "your_key"
+      }
     }
   }
 }
@@ -184,14 +205,39 @@ For the local variant, export `CONTEXTSTREAM_API_KEY` before launching OpenCode.
 <details>
 <summary><b>VS Code</b></summary>
 
+For GitHub Copilot in VS Code, use project-level MCP at `.vscode/mcp.json`.
+
+**Rust MCP (recommended)**
+
+```json
+{
+  "servers": {
+    "contextstream": {
+      "type": "stdio",
+      "command": "contextstream-mcp",
+      "args": [],
+      "env": {
+        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
+        "CONTEXTSTREAM_API_KEY": "your_key"
+      }
+    }
+  }
+}
+```
+
+**Node MCP server**
+
 ```json
 {
   "servers": {
     "contextstream": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@contextstream/mcp-server"],
-      "env": { "CONTEXTSTREAM_API_KEY": "your_key" }
+      "args": ["--prefer-online", "-y", "@contextstream/mcp-server@latest"],
+      "env": {
+        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
+        "CONTEXTSTREAM_API_KEY": "your_key"
+      }
     }
   }
 }
@@ -208,15 +254,37 @@ Use the Copilot CLI to interactively add the MCP server:
 /mcp add
 ```
 
-Or add to `~/.copilot/mcp-config.json`:
+Or add to `~/.copilot/mcp-config.json` (pick one runtime):
+
+**Rust MCP (recommended)**
+
+```json
+{
+  "mcpServers": {
+    "contextstream": {
+      "command": "contextstream-mcp",
+      "args": [],
+      "env": {
+        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
+        "CONTEXTSTREAM_API_KEY": "your_key"
+      }
+    }
+  }
+}
+```
+
+**Node MCP server**
 
 ```json
 {
   "mcpServers": {
     "contextstream": {
       "command": "npx",
-      "args": ["-y", "@contextstream/mcp-server"],
-      "env": { "CONTEXTSTREAM_API_KEY": "your_key" }
+      "args": ["--prefer-online", "-y", "@contextstream/mcp-server@latest"],
+      "env": {
+        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
+        "CONTEXTSTREAM_API_KEY": "your_key"
+      }
     }
   }
 }
@@ -228,6 +296,28 @@ For more information, see the [GitHub Copilot CLI documentation](https://docs.gi
 
 ---
 
+## VS Code + Copilot Tips
+
+- Run setup once and keep both config files:
+  - `~/.copilot/mcp-config.json`
+  - `.vscode/mcp.json`
+- Rust install: use `contextstream-mcp` as the command.
+- Node install: use `npx --prefer-online -y @contextstream/mcp-server@latest` as the command.
+- Use `mcpServers` in Copilot CLI config and `servers` in VS Code config.
+
+## Quick Troubleshooting
+
+- Remove duplicate ContextStream entries across Workspace/User config scopes.
+- Check `CONTEXTSTREAM_API_URL` and `CONTEXTSTREAM_API_KEY` are set.
+- Remove stale version pins like `@contextstream/mcp-server@0.3.xx`.
+- Restart VS Code/Copilot after config changes.
+
+## Marketplace Note
+
+Marketplace npm installs can pin Node MCP versions and do not run external bootstrap scripts (`curl ... | bash` / `irm ... | iex`). Use the Rust install command directly when you want the Rust runtime.
+
+---
+
 ## Links
 
 **Website:** https://contextstream.io