@openbiox/bizard-mcp 0.1.1 → 0.1.3

package/README.md

@@ -1,7 +1,8 @@
 # @openbiox/bizard-mcp
 
 A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for
-the [Bizard](https://bizard.app) biomedical visualization atlas. It serves the
+the [Bizard](https://openbiox.github.io/Bizard/) biomedical visualization
+atlas ([GitHub](https://github.com/openbiox/Bizard)). It serves the
 full chart lifecycle over MCP: **query** (bilingual search across 800+ chart
 tutorials), **use** (runnable code, dependencies, data URLs, and structured
 adaptation guidance the host AI executes), **cite** (BibTeX/DOI metadata with
@@ -10,28 +11,37 @@ degrades gracefully by environment). Content comes from a bundle generated by
 CI from the same sources as the website and `SKILL.md`, so all three never
 drift. The server never executes plotting code — the host AI does.
 
-## Quickstart (local, stdio)
+## Quickstart
+
+No install at all — connect to the [public hosted instance](#public-hosted-instance-no-install-required)
+(pure Streamable HTTP, works with any MCP-capable agent).
+
+Local, stdio (works offline — an npm-shipped content snapshot backs everything up):
 
 ```bash
 npx @openbiox/bizard-mcp
 ```
 
-Register it with Claude Code:
+Register the local server with Claude Code:
 
 ```bash
 claude mcp add bizard -- npx @openbiox/bizard-mcp
 ```
 
-Works offline: an npm-shipped content snapshot backs everything up.
+Hosted instance with Claude Code:
+
+```bash
+claude mcp add --transport http bizard http://biotree.top:38123/bizard-mcp/mcp
+```
 
 ## Tools
 
 | Tool | Purpose |
 |------|---------|
 | `bizard_search` | Bilingual weighted search over the chart gallery; adjacent-category suggestions on zero hits |
-| `bizard_list_categories` | Category tree (12 Level-1 categories with Chinese/English aliases and counts) |
-| `bizard_get_tutorial` | Structured tutorial content: sections, setup dependencies, data description, key parameters |
-| `bizard_get_code` | Runnable tutorial code with package list, install guard, and example-data URLs |
+| `bizard_list_categories` | All 36 chart categories with per-category chart counts (bilingual names where available) |
+| `bizard_get_tutorial` | Chart metadata: packages, example-data URLs, available languages, tutorial link |
+| `bizard_get_code` | Runnable tutorial code with package list, example-data URLs, and license notice |
 | `bizard_adapt_guidance` | Data-shape checks, dependency prep, parameter mapping, failure modes, alternatives |
 | `bizard_cite` | Bizard paper + tutorial citation (bibtex/text/json) with CC-BY-NC-4.0 license notice |
 | `bizard_contribute_check` | Validate a draft against the contribution template; preview points (issue #4) |
@@ -47,6 +57,33 @@ One package, two transports:
 - **Local (stdio, default)**: `npx @openbiox/bizard-mcp`. Full capability; contribution runs at level 1/2 when local credentials exist.
 - **Hosted (Streamable HTTP)**: `npx @openbiox/bizard-mcp --http`. Port via `BIZARD_HTTP_PORT` (default 3000). Anonymous, stateless — each POST to `/mcp` gets a fresh transport. Per-IP token-bucket rate limit (60 req/min; 429 with `Retry-After`). Contribution runs at level 3 (no credentials on the server).
 
+### Public hosted instance (no install required)
+
+A community instance is deployed by the Bizard team. It speaks standard
+Streamable HTTP, so **any MCP-capable agent** can connect — Claude Code,
+Cursor, Cline, Windsurf, VS Code Copilot Chat, custom agent frameworks —
+with no local install. It may also be faster than an npm-based setup for
+users in mainland China.
+
+Most MCP clients accept a JSON server entry:
+
+```json
+{
+  "mcpServers": {
+    "bizard": { "type": "http", "url": "http://biotree.top:38123/bizard-mcp/mcp" }
+  }
+}
+```
+
+Claude Code accepts it from the CLI too:
+
+```bash
+claude mcp add --transport http bizard http://biotree.top:38123/bizard-mcp/mcp
+```
+
+Same anonymous, stateless, rate-limited behavior as the self-hosted HTTP
+mode; contribution runs at level 3 (the instance holds no credentials).
+
 ## Contribution credential degradation
 
 `bizard_contribute_submit` probes the environment on every call and states
@@ -54,7 +91,7 @@ which level it used — never silently failing:
 
 | Level | Condition | Behavior |
 |-------|-----------|----------|
-| 1 | `gh` CLI installed and logged in | Creates issue (or PR when `asPR`) as the user |
+| 1 | `gh` CLI installed and logged in | Creates the issue as your GitHub user (PR submission is planned for a future release) |
 | 2 | No `gh`, but `GITHUB_TOKEN` set | GitHub API submission, limited by token scope |
 | 3 | Neither (typical for hosted) | Returns formatted draft + pre-filled `issues/new?title=&body=` deep-link |
 

package/dist/server.js

@@ -13,9 +13,17 @@ const QUERY_MAX_CHARS = 4000;
 export const NO_BUNDLE_ERROR = "bizard-mcp: bundle snapshot unavailable. The maintainer must run " +
     "`npm run build:bundle` (or CI) to generate src/snapshot/bundle.json, then rebuild.";
 function json(value, note) {
-    const payload = note === null || note === undefined
-        ? { ...value }
-        : { note, ...value };
+    // Arrays must be serialized as arrays: spreading an array into an object
+    // literal ({...arr}) yields numeric-string keys and breaks client-side
+    // .map()/.length. Wrap noted arrays as {note, items} so `.note` stays
+    // accessible for the one-time update notice (see notice-wiring tests).
+    let payload;
+    if (note === null || note === undefined) {
+        payload = Array.isArray(value) ? value : { ...value };
+    }
+    else {
+        payload = Array.isArray(value) ? { note, items: value } : { note, ...value };
+    }
     return {
         content: [{
                 type: "text",
@@ -30,7 +38,7 @@ function bundleError() {
     };
 }
 /** Constant server identity — never derives from bundle state. */
-const SERVER_IDENTITY = { name: "bizard-mcp", version: "0.1.1" };
+const SERVER_IDENTITY = { name: "bizard-mcp", version: "0.1.3" };
 export function createBizardServer(source, notices, opts) {
     const getBundle = () => {
         if (source === null)

package/dist/snapshot/bundle.json

@@ -2,7 +2,7 @@
   "meta": {
     "siteVersion": "",
     "bundleVersion": 1,
-    "generatedAt": "2026-10-16T02:07:57.948676+00:00",
+    "generatedAt": "2026-10-16T09:50:57.083657+00:00",
     "license": "CC-BY-NC-4.0"
   },
   "categories": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openbiox/bizard-mcp",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "MCP server for the Bizard biomedical visualization atlas: search, adapt, cite, and contribute chart tutorials",
   "type": "module",
   "engines": { "node": ">=20" },