@usercase/mcp 0.2.10-next.3 → 0.2.10-next.4

package/README.md

@@ -67,6 +67,14 @@ The number is how many people visit in total (default 5). Above 5, Claude works
 
 With `unlimited` it keeps going until you press Esc. Every visit uses your Claude usage.
 
+### Take part in a research
+
+Give a research id from your dashboard and the people take part in it instead of exploring freely — they accept its invitation and do its tasks from the study panel, the way invited participants do. The research must be live.
+
+```
+/mcp__usercase__research https://staging.example.com 10 research=<research id>
+```
+
 When a visit ends, it is sent to your dashboard (**Visits**). If the upload fails, it is kept in `.usercase/outbox.jsonl` and sent with the next one.
 
 ### Sites behind a sign-in

package/mcp/server.js

@@ -928,6 +928,30 @@ const pathWalkRules = () => {
     .trim();
 };
 
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+/**
+ * 명령 인자를 이름으로 맞춘다. Claude Code 는 /mcp__usercase__research 의 인자를 띄어쓰기로 나눠 순서대로 넘긴다 —
+ * `research=<id>` 라고 써도 세 번째 자리(focus)에 "research=<id>" 로 들어가, 리서치가 아니라 초점 판으로 돌았다(10/30 라이브 bluetags).
+ * 그래서 어느 자리에 있든 `이름=값`(또는 `이름:값`)이면 그 이름으로 옮기고, research 를 받는 명령에서는 이름 없는 리서치 id(UUID)도 research 로 본다
+ */
+function byName(args = {}, schema = {}) {
+  const names = Object.keys(schema || {});
+  const out = {};
+  const loose = [];
+  for (const [k, raw] of Object.entries(args || {})) {
+    if (raw == null) continue;
+    const v = String(raw).trim();
+    const m = v.match(/^([a-z]+)\s*[=:]\s*(.*)$/is);
+    if (m && names.includes(m[1].toLowerCase())) out[m[1].toLowerCase()] = m[2].trim();
+    else if (names.includes("research") && UUID.test(v.replace(/^research\s+/i, ""))) out.research = v.replace(/^research\s+/i, "");
+    else loose.push([k, v]);
+  }
+  // 이름 없이 온 값은 제자리에 — 이름으로 이미 채운 자리는 덮지 않는다
+  for (const [k, v] of loose) if (!(k in out) && v !== "") out[k] = v;
+  return out;
+}
+
 /**
  * 명령 지시문. 따로 쓰면 MCP 프롬프트(/mcp__usercase__research), 플러그인이면 instructions 도구(/usercase:research 스킬이 부른다)로
  * 같은 글이 나간다
@@ -1043,12 +1067,12 @@ if (PLUGIN || CODEX || OTHER) {
         ...COMMANDS.steps.argsSchema,
       },
     },
-    wrap(async ({ command, ...args }) => text(COMMANDS[command].body(args))),
+    wrap(async ({ command, ...args }) => text(COMMANDS[command].body(byName(args, COMMANDS[command].argsSchema)))),
   );
 } else {
   for (const [name, c] of Object.entries(COMMANDS)) {
     const meta = c.argsSchema ? { description: c.description, argsSchema: c.argsSchema } : { description: c.description };
-    server.registerPrompt(name, meta, (args = {}) => ({ messages: [{ role: "user", content: { type: "text", text: c.body(args) } }] }));
+    server.registerPrompt(name, meta, (args = {}) => ({ messages: [{ role: "user", content: { type: "text", text: c.body(byName(args, c.argsSchema)) } }] }));
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usercase/mcp",
-  "version": "0.2.10-next.3",
+  "version": "0.2.10-next.4",
   "description": "Virtual users that browse your website and tell you what they thought — an MCP server for Claude Code",
   "license": "UNLICENSED",
   "homepage": "https://usercase.io",