@crush-protocol/mcp-client 0.3.1 → 0.3.2

package/README.md

@@ -60,15 +60,14 @@ Detailed tool guidance is in [INSTRUCTIONS.md](./INSTRUCTIONS.md).
 
 ## Client Configuration
 
-### Cursor
+<details>
+<summary><strong>Cursor</strong></summary>
 
 [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=crush-protocol&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjcnVzaC1wcm90b2NvbC9tY3AtY2xpZW50Il19)
 
-[Cursor MCP docs](https://docs.cursor.com/context/model-context-protocol)
+[Cursor MCP docs](https://docs.cursor.com/context/model-context-protocol) · Go to: `Settings` → `Cursor Settings` → `MCP` → `Add new global MCP server`
 
-Go to: `Settings` → `Cursor Settings` → `MCP` → `Add new global MCP server`
-
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -81,7 +80,7 @@ Go to: `Settings` → `Cursor Settings` → `MCP` → `Add new global MCP server
 }
 ```
 
-#### Remote Server Connection
+**Remote:**
 
 ```json
 {
@@ -93,33 +92,33 @@ Go to: `Settings` → `Cursor Settings` → `MCP` → `Add new global MCP server
 }
 ```
 
----
+</details>
 
-### Claude Code
+<details>
+<summary><strong>Claude Code</strong></summary>
 
 [Claude Code MCP docs](https://docs.anthropic.com/en/docs/claude-code/mcp)
 
-#### Local Server Connection
+**Local:**
 
 ```sh
 claude mcp add --scope user crush-protocol -- npx -y @crush-protocol/mcp-client
 ```
 
-#### Remote Server Connection
+**Remote:**
 
 ```sh
 claude mcp add --scope user --transport http crush-protocol https://crush-mcp-ats.dev.xexlab.com/mcp
 ```
 
----
-
-### OpenCode
+</details>
 
-[OpenCode MCP docs](https://opencode.ai/docs/mcp-servers)
+<details>
+<summary><strong>OpenCode</strong></summary>
 
-Add to `~/.config/opencode/opencode.json`:
+[OpenCode MCP docs](https://opencode.ai/docs/mcp-servers) · Add to `~/.config/opencode/opencode.json`
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -134,7 +133,7 @@ Add to `~/.config/opencode/opencode.json`:
 }
 ```
 
-#### Remote Server Connection
+**Remote:**
 
 ```json
 {
@@ -149,21 +148,16 @@ Add to `~/.config/opencode/opencode.json`:
 }
 ```
 
----
+</details>
 
-### OpenAI Codex
+<details>
+<summary><strong>OpenAI Codex</strong></summary>
 
 [OpenAI Codex MCP docs](https://developers.openai.com/codex/mcp)
 
-#### Using CLI
-
-```sh
-codex mcp add crush-protocol -- npx -y @crush-protocol/mcp-client
-```
-
-#### Local Server Connection
+**CLI:** `codex mcp add crush-protocol -- npx -y @crush-protocol/mcp-client`
 
-Add to `~/.codex/config.toml`:
+**Local** (add to `~/.codex/config.toml`):
 
 ```toml
 [mcp_servers.crush-protocol]
@@ -172,22 +166,21 @@ args = ["-y", "@crush-protocol/mcp-client"]
 startup_timeout_ms = 20000
 ```
 
-#### Remote Server Connection
+**Remote:**
 
 ```toml
 [mcp_servers.crush-protocol]
 url = "https://crush-mcp-ats.dev.xexlab.com/mcp"
 ```
 
----
+</details>
 
-### Google Gemini CLI
+<details>
+<summary><strong>Google Gemini CLI</strong></summary>
 
-[Gemini CLI Configuration](https://google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html)
+[Gemini CLI Configuration](https://google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html) · Add to `~/.gemini/settings.json`
 
-Add to `~/.gemini/settings.json`:
-
-#### Remote Server Connection
+**Remote:**
 
 ```json
 {
@@ -199,7 +192,7 @@ Add to `~/.gemini/settings.json`:
 }
 ```
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -212,15 +205,14 @@ Add to `~/.gemini/settings.json`:
 }
 ```
 
----
-
-### VS Code
+</details>
 
-[VS Code MCP docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)
+<details>
+<summary><strong>VS Code</strong></summary>
 
-Add to `.vscode/mcp.json`:
+[VS Code MCP docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) · Add to `.vscode/mcp.json`
 
-#### Remote Server Connection
+**Remote:**
 
 ```json
 {
@@ -233,7 +225,7 @@ Add to `.vscode/mcp.json`:
 }
 ```
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -247,13 +239,14 @@ Add to `.vscode/mcp.json`:
 }
 ```
 
----
+</details>
 
-### Windsurf
+<details>
+<summary><strong>Windsurf</strong></summary>
 
 [Windsurf MCP docs](https://docs.windsurf.com/windsurf/cascade/mcp)
 
-#### Remote Server Connection
+**Remote:**
 
 ```json
 {
@@ -265,7 +258,7 @@ Add to `.vscode/mcp.json`:
 }
 ```
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -278,15 +271,14 @@ Add to `.vscode/mcp.json`:
 }
 ```
 
----
-
-### Claude Desktop
+</details>
 
-[Claude Desktop MCP docs](https://modelcontextprotocol.io/quickstart/user)
+<details>
+<summary><strong>Claude Desktop</strong></summary>
 
-Edit `claude_desktop_config.json`:
+[Claude Desktop MCP docs](https://modelcontextprotocol.io/quickstart/user) · Edit `claude_desktop_config.json`
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -299,15 +291,14 @@ Edit `claude_desktop_config.json`:
 }
 ```
 
----
+</details>
 
-### Kiro
+<details>
+<summary><strong>Kiro</strong></summary>
 
-[Kiro MCP docs](https://kiro.dev/docs/mcp/configuration/)
+[Kiro MCP docs](https://kiro.dev/docs/mcp/configuration/) · Navigate `Kiro` → `MCP Servers` → `+ Add`
 
-Navigate `Kiro` → `MCP Servers` → `+ Add`, paste the configuration:
-
-#### Remote Server Connection
+**Remote:**
 
 ```json
 {
@@ -319,7 +310,7 @@ Navigate `Kiro` → `MCP Servers` → `+ Add`, paste the configuration:
 }
 ```
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -332,13 +323,14 @@ Navigate `Kiro` → `MCP Servers` → `+ Add`, paste the configuration:
 }
 ```
 
----
+</details>
 
-### Roo Code
+<details>
+<summary><strong>Roo Code</strong></summary>
 
 [Roo Code MCP docs](https://docs.roocode.com/features/mcp/using-mcp-in-roo)
 
-#### Remote Server Connection
+**Remote:**
 
 ```json
 {
@@ -351,7 +343,7 @@ Navigate `Kiro` → `MCP Servers` → `+ Add`, paste the configuration:
 }
 ```
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -364,13 +356,14 @@ Navigate `Kiro` → `MCP Servers` → `+ Add`, paste the configuration:
 }
 ```
 
----
+</details>
 
-### Cline
+<details>
+<summary><strong>Cline</strong></summary>
 
 [Cline MCP Marketplace](https://cline.bot/mcp-marketplace)
 
-#### Remote Server Connection
+**Remote:**
 
 ```json
 {
@@ -383,7 +376,7 @@ Navigate `Kiro` → `MCP Servers` → `+ Add`, paste the configuration:
 }
 ```
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -396,13 +389,14 @@ Navigate `Kiro` → `MCP Servers` → `+ Add`, paste the configuration:
 }
 ```
 
----
+</details>
 
-### Trae
+<details>
+<summary><strong>Trae</strong></summary>
 
 [Trae MCP docs](https://docs.trae.ai/ide/model-context-protocol?_lang=en)
 
-#### Remote Server Connection
+**Remote:**
 
 ```json
 {
@@ -414,7 +408,7 @@ Navigate `Kiro` → `MCP Servers` → `+ Add`, paste the configuration:
 }
 ```
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -427,9 +421,10 @@ Navigate `Kiro` → `MCP Servers` → `+ Add`, paste the configuration:
 }
 ```
 
----
+</details>
 
-### Augment Code
+<details>
+<summary><strong>Augment Code</strong></summary>
 
 1. Click hamburger menu → Settings → Tools → `+ Add MCP`
 2. Enter command: `npx -y @crush-protocol/mcp-client`
@@ -449,13 +444,14 @@ Manual config in VS Code settings:
 }
 ```
 
----
+</details>
 
-### Copilot Coding Agent
+<details>
+<summary><strong>Copilot Coding Agent</strong></summary>
 
 [GitHub Copilot MCP docs](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp)
 
-#### Remote Server Connection
+**Remote:**
 
 ```json
 {
@@ -468,7 +464,7 @@ Manual config in VS Code settings:
 }
 ```
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -482,13 +478,14 @@ Manual config in VS Code settings:
 }
 ```
 
----
+</details>
 
-### Copilot CLI
+<details>
+<summary><strong>Copilot CLI</strong></summary>
 
 Add to `~/.copilot/mcp-config.json`:
 
-#### Remote Server Connection
+**Remote:**
 
 ```json
 {
@@ -501,7 +498,7 @@ Add to `~/.copilot/mcp-config.json`:
 }
 ```
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -515,9 +512,10 @@ Add to `~/.copilot/mcp-config.json`:
 }
 ```
 
----
+</details>
 
-### Amazon Q Developer CLI
+<details>
+<summary><strong>Amazon Q Developer CLI</strong></summary>
 
 [Amazon Q Developer CLI docs](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html)
 
@@ -532,13 +530,12 @@ Add to `~/.copilot/mcp-config.json`:
 }
 ```
 
----
-
-### Warp
+</details>
 
-[Warp MCP docs](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server)
+<details>
+<summary><strong>Warp</strong></summary>
 
-Navigate `Settings` → `AI` → `Manage MCP servers` → `+ Add`:
+[Warp MCP docs](https://docs.warp.dev/knowledge-and-collaboration/mcp#adding-an-mcp-server) · Navigate `Settings` → `AI` → `Manage MCP servers` → `+ Add`
 
 ```json
 {
@@ -552,9 +549,10 @@ Navigate `Settings` → `AI` → `Manage MCP servers` → `+ Add`:
 }
 ```
 
----
+</details>
 
-### Amp
+<details>
+<summary><strong>Amp</strong></summary>
 
 [Amp MCP docs](https://ampcode.com/manual#mcp)
 
@@ -562,13 +560,12 @@ Navigate `Settings` → `AI` → `Manage MCP servers` → `+ Add`:
 amp mcp add crush-protocol https://crush-mcp-ats.dev.xexlab.com/mcp
 ```
 
----
+</details>
 
-### Zed
+<details>
+<summary><strong>Zed</strong></summary>
 
-[Zed Context Server docs](https://zed.dev/docs/assistant/context-servers)
-
-Add to `settings.json`:
+[Zed Context Server docs](https://zed.dev/docs/assistant/context-servers) · Add to `settings.json`
 
 ```json
 {
@@ -582,15 +579,14 @@ Add to `settings.json`:
 }
 ```
 
----
-
-### JetBrains AI Assistant
+</details>
 
-[JetBrains AI Assistant docs](https://www.jetbrains.com/help/ai-assistant/configure-an-mcp-server.html)
+<details>
+<summary><strong>JetBrains AI Assistant</strong></summary>
 
-Go to `Settings` → `Tools` → `AI Assistant` → `Model Context Protocol (MCP)` → `+ Add`
+[JetBrains AI Assistant docs](https://www.jetbrains.com/help/ai-assistant/configure-an-mcp-server.html) · Go to `Settings` → `Tools` → `AI Assistant` → `Model Context Protocol (MCP)` → `+ Add`
 
-#### Remote Server Connection
+**Remote:**
 
 ```json
 {
@@ -602,7 +598,7 @@ Go to `Settings` → `Tools` → `AI Assistant` → `Model Context Protocol (MCP
 }
 ```
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -615,21 +611,16 @@ Go to `Settings` → `Tools` → `AI Assistant` → `Model Context Protocol (MCP
 }
 ```
 
----
+</details>
 
-### Qwen Code
+<details>
+<summary><strong>Qwen Code</strong></summary>
 
 [Qwen Code MCP docs](https://qwenlm.github.io/qwen-code-docs/en/users/features/mcp/)
 
-#### Using CLI
-
-```sh
-qwen mcp add crush-protocol npx -y @crush-protocol/mcp-client
-```
-
-#### Remote Server Connection
+**CLI:** `qwen mcp add crush-protocol npx -y @crush-protocol/mcp-client`
 
-Add to `~/.qwen/settings.json`:
+**Remote** (add to `~/.qwen/settings.json`):
 
 ```json
 {
@@ -641,7 +632,7 @@ Add to `~/.qwen/settings.json`:
 }
 ```
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -654,13 +645,12 @@ Add to `~/.qwen/settings.json`:
 }
 ```
 
----
+</details>
 
-### LM Studio
+<details>
+<summary><strong>LM Studio</strong></summary>
 
-[LM Studio MCP Support](https://lmstudio.ai/blog/lmstudio-v0.3.17)
-
-Navigate `Program` → `Install` → `Edit mcp.json`:
+[LM Studio MCP Support](https://lmstudio.ai/blog/lmstudio-v0.3.17) · Navigate `Program` → `Install` → `Edit mcp.json`
 
 ```json
 {
@@ -673,13 +663,14 @@ Navigate `Program` → `Install` → `Edit mcp.json`:
 }
 ```
 
----
+</details>
 
-### Visual Studio 2022
+<details>
+<summary><strong>Visual Studio 2022</strong></summary>
 
 [Visual Studio MCP docs](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022)
 
-#### Remote Server Connection
+**Remote:**
 
 ```json
 {
@@ -693,7 +684,7 @@ Navigate `Program` → `Install` → `Edit mcp.json`:
 }
 ```
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -709,9 +700,10 @@ Navigate `Program` → `Install` → `Edit mcp.json`:
 }
 ```
 
----
+</details>
 
-### BoltAI
+<details>
+<summary><strong>BoltAI</strong></summary>
 
 [BoltAI docs](https://docs.boltai.com/docs/plugins/mcp-servers)
 
@@ -726,15 +718,12 @@ Navigate `Program` → `Install` → `Edit mcp.json`:
 }
 ```
 
----
-
-### Perplexity Desktop
-
-[Perplexity MCP docs](https://www.perplexity.ai/help-center/en/articles/11502712-local-and-remote-mcps-for-perplexity)
+</details>
 
-Navigate `Perplexity` → `Settings` → `Connectors` → `Add Connector` → `Advanced`
+<details>
+<summary><strong>Perplexity Desktop</strong></summary>
 
-Server Name: `crush-protocol`
+[Perplexity MCP docs](https://www.perplexity.ai/help-center/en/articles/11502712-local-and-remote-mcps-for-perplexity) · Navigate `Perplexity` → `Settings` → `Connectors` → `Add Connector` → `Advanced` · Server Name: `crush-protocol`
 
 ```json
 {
@@ -744,13 +733,14 @@ Server Name: `crush-protocol`
 }
 ```
 
----
+</details>
 
-### Kilo Code
+<details>
+<summary><strong>Kilo Code</strong></summary>
 
 [Kilo Code docs](https://kilocode.ai)
 
-#### Remote Server Connection
+**Remote:**
 
 ```json
 {
@@ -763,7 +753,7 @@ Server Name: `crush-protocol`
 }
 ```
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -776,12 +766,12 @@ Server Name: `crush-protocol`
 }
 ```
 
----
+</details>
 
-### Zencoder
+<details>
+<summary><strong>Zencoder</strong></summary>
 
-1. Go to Zencoder menu → Agent tools → Add custom MCP
-2. Paste:
+Go to Zencoder menu → Agent tools → Add custom MCP, paste:
 
 ```json
 {
@@ -790,15 +780,14 @@ Server Name: `crush-protocol`
 }
 ```
 
----
+</details>
 
-### Qodo Gen
+<details>
+<summary><strong>Qodo Gen</strong></summary>
 
-[Qodo Gen docs](https://docs.qodo.ai/qodo-documentation/qodo-gen/qodo-gen-chat/agentic-mode/agentic-tools-mcps)
+[Qodo Gen docs](https://docs.qodo.ai/qodo-documentation/qodo-gen/qodo-gen-chat/agentic-mode/agentic-tools-mcps) · Open Qodo Gen chat → Connect more tools → `+ Add new MCP`
 
-Open Qodo Gen chat → Connect more tools → `+ Add new MCP`:
-
-#### Remote Server Connection
+**Remote:**
 
 ```json
 {
@@ -810,7 +799,7 @@ Open Qodo Gen chat → Connect more tools → `+ Add new MCP`:
 }
 ```
 
-#### Local Server Connection
+**Local:**
 
 ```json
 {
@@ -823,11 +812,12 @@ Open Qodo Gen chat → Connect more tools → `+ Add new MCP`:
 }
 ```
 
----
+</details>
 
-### Using Bun or Deno
+<details>
+<summary><strong>Using Bun or Deno</strong></summary>
 
-#### Bun
+**Bun:**
 
 ```json
 {
@@ -840,7 +830,7 @@ Open Qodo Gen chat → Connect more tools → `+ Add new MCP`:
 }
 ```
 
-#### Deno
+**Deno:**
 
 ```json
 {
@@ -860,9 +850,10 @@ Open Qodo Gen chat → Connect more tools → `+ Add new MCP`:
 }
 ```
 
----
+</details>
 
-### Windows
+<details>
+<summary><strong>Windows</strong></summary>
 
 Use `cmd` as the command wrapper:
 
@@ -877,6 +868,8 @@ Use `cmd` as the command wrapper:
 }
 ```
 
+</details>
+
 ## CLI Usage
 
 ```sh

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crush-protocol/mcp-client",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Crush MCP npm client package (remote Streamable HTTP + optional ClickHouse direct)",
   "type": "module",
   "license": "MIT",