@kuluomi/mapp-router-mcp 0.3.4 → 0.3.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -3
- package/package.json +1 -1
- package/server.mjs +42 -11
package/README.md
CHANGED
|
@@ -25,7 +25,7 @@ stdio 形态下 stdout 只走协议帧,所有日志走 stderr。HTTP 形态下
|
|
|
25
25
|
|
|
26
26
|
## 提供四个工具
|
|
27
27
|
|
|
28
|
-
`mcp_probe` 回显运行身份,用来验证通道通不通。`list_apps` 拉候选应用(应用广场的 agent / team,加上账号自己在平台上建的应用)。`run_app` 把一段完整任务转交给选中的应用,当场最多等约
|
|
28
|
+
`mcp_probe` 回显运行身份,用来验证通道通不通。`list_apps` 拉候选应用(应用广场的 agent / team,加上账号自己在平台上建的应用)。`run_app` 把一段完整任务转交给选中的应用,当场最多等约 45 秒,超时就回 `task_id`。`fetch_run_result` 按 `task_id` 取结果,每次调用自己阻塞最多约 45 秒 —— 等待放在工具里,而不是让模型多问几遍(每问一遍都是一整次模型回合)。
|
|
29
29
|
|
|
30
30
|
## 环境变量
|
|
31
31
|
|
|
@@ -37,7 +37,7 @@ stdio 形态下 stdout 只走协议帧,所有日志走 stderr。HTTP 形态下
|
|
|
37
37
|
| `ROUTER_PORT` | 否 | HTTP 端口,默认 5173 |
|
|
38
38
|
| `ROUTER_EXCLUDE_IDS` | 否 | 逗号分隔的 app_id,从候选清单里摘掉 |
|
|
39
39
|
| `ROUTER_OWNER_USER_ID` | 否 | 应用归属判定用的账号 uid;不配就从个人空间那几条自己认 |
|
|
40
|
-
| `MCP_RUN_INLINE_WAIT_MS` / `MCP_FETCH_WAIT_MS` | 否 | `run_app` 当场等待与 `fetch_run_result` 单次阻塞的上限,默认
|
|
40
|
+
| `MCP_RUN_INLINE_WAIT_MS` / `MCP_FETCH_WAIT_MS` | 否 | `run_app` 当场等待与 `fetch_run_result` 单次阻塞的上限,默认 45000 / 45000 ms(实测平台单次调用 55 秒不被掐断,留约 10 秒余量) |
|
|
41
41
|
| `MCP_ANSWER_MAX_CHARS` / `MCP_CONFIG_PASS_MAX_CHARS` | 否 | 回答进模型上下文的上限,默认 12000;带 ```agent-config / ```team-config 的回答改用后一个(默认 20000),截断会让前端那张确认卡片解析不出来 |
|
|
42
42
|
|
|
43
43
|
`MAPP_ACCESS_TOKEN` 缺了不影响 `mcp_probe` 和广场那半份清单,只是「我的应用」和 `run_app` 会明确报缺密钥。本地开发时它也可以不配——进程会退回到读同仓库 `.env.development` 里的 `VITE_MARKETPLACE_ACCESS_TOKEN`(那个文件在 gitignore 里,不会跟着仓库出去)。
|
|
@@ -64,4 +64,4 @@ stdio 形态下 stdout 只走协议帧,所有日志走 stderr。HTTP 形态下
|
|
|
64
64
|
|
|
65
65
|
**密钥明文存在平台配置里。** 上面那个 `env` 块是明文保存的,而且这类 MCP 配置能被读回来(工具库里那条 wigolo 的 Bearer 就是这么被原样取出的)。不想接受这个代价,就继续用 HTTP 形态——那种情况下密钥只在自己机器上。
|
|
66
66
|
|
|
67
|
-
**stdio 每次都是冷启。** 进程用完就关,注册表缓存随之没了,第一次 `list_apps` 会慢(本地实测首次约 2.7 秒,缓存后约 0.6
|
|
67
|
+
**stdio 每次都是冷启。** 进程用完就关,注册表缓存随之没了,第一次 `list_apps` 会慢(本地实测首次约 2.7 秒,缓存后约 0.6 秒)。平台侧单次工具调用实测 55 秒仍能返回,但 `list_apps` 仍应压在几秒内 —— 它是路由的第一步,不是干活的那一步。
|
package/package.json
CHANGED
package/server.mjs
CHANGED
|
@@ -29514,8 +29514,8 @@ var FACTORY_MAX_PAGES = 10;
|
|
|
29514
29514
|
var OWNER_UID = (process.env.ROUTER_OWNER_USER_ID ?? "").trim();
|
|
29515
29515
|
var SKIP_SELF_APPS = /^(1|true|yes)$/i.test(process.env.ROUTER_SKIP_SELF_APPS ?? "");
|
|
29516
29516
|
var RUN_TIMEOUT_MS = Number(process.env.MCP_RUN_TIMEOUT_MS ?? 3e5);
|
|
29517
|
-
var RUN_INLINE_WAIT_MS = Number(process.env.MCP_RUN_INLINE_WAIT_MS ??
|
|
29518
|
-
var FETCH_WAIT_MS = Number(process.env.MCP_FETCH_WAIT_MS ??
|
|
29517
|
+
var RUN_INLINE_WAIT_MS = Number(process.env.MCP_RUN_INLINE_WAIT_MS ?? 45e3);
|
|
29518
|
+
var FETCH_WAIT_MS = Number(process.env.MCP_FETCH_WAIT_MS ?? 45e3);
|
|
29519
29519
|
var SANDBOX_ROOT = (process.env.MAPP_SANDBOX_ROOT ?? "/tmp/mapp_sandbox_rootfs").replace(/\/$/, "");
|
|
29520
29520
|
var UPLOAD_ORIGIN = (process.env.MAPP_UPLOAD_ORIGIN ?? "https://agent-ui.quchiai.com").replace(/\/$/, "");
|
|
29521
29521
|
var UPLOAD_MAX_BYTES = Number(process.env.MCP_UPLOAD_MAX_BYTES ?? 25 * 1024 * 1024);
|
|
@@ -29532,7 +29532,7 @@ var DEFAULT_EXCLUDE_IDS = ["48621dce-c1df-4e1d-b6a4-be12f2ddcad3"];
|
|
|
29532
29532
|
for (const id of DEFAULT_EXCLUDE_IDS) EXCLUDE_IDS.add(id);
|
|
29533
29533
|
var BOOT_ID = randomUUID().slice(0, 8);
|
|
29534
29534
|
var STARTED_AT = (/* @__PURE__ */ new Date()).toISOString();
|
|
29535
|
-
var SERVER_VERSION = "0.3.
|
|
29535
|
+
var SERVER_VERSION = "0.3.6";
|
|
29536
29536
|
function cwdPeek(limit = 8) {
|
|
29537
29537
|
try {
|
|
29538
29538
|
const names = readdirSync(process.cwd()).filter((n) => !n.startsWith("."));
|
|
@@ -29612,6 +29612,10 @@ async function uploadFileToApp({ appId, uid, filePath }) {
|
|
|
29612
29612
|
}
|
|
29613
29613
|
var callCount = 0;
|
|
29614
29614
|
var recentCalls = [];
|
|
29615
|
+
var runningByKey = /* @__PURE__ */ new Map();
|
|
29616
|
+
function taskKeyOf(appId, sessionId, message, filePaths) {
|
|
29617
|
+
return [appId, sessionId ?? "", message, (filePaths ?? []).join("|")].join("\0");
|
|
29618
|
+
}
|
|
29615
29619
|
function log(...args) {
|
|
29616
29620
|
console.error(`[${(/* @__PURE__ */ new Date()).toISOString()}]`, ...args);
|
|
29617
29621
|
}
|
|
@@ -29892,10 +29896,11 @@ function pruneTasks() {
|
|
|
29892
29896
|
}
|
|
29893
29897
|
}
|
|
29894
29898
|
}
|
|
29895
|
-
function startTask(hit, message, sessionId) {
|
|
29899
|
+
function startTask(hit, message, sessionId, dedupeKey = "") {
|
|
29896
29900
|
const id = `t_${randomUUID().slice(0, 8)}`;
|
|
29897
29901
|
const task = {
|
|
29898
29902
|
id,
|
|
29903
|
+
key: dedupeKey,
|
|
29899
29904
|
app_name: hit.name,
|
|
29900
29905
|
app_id: hit.id,
|
|
29901
29906
|
agent_type: hit.agent_type,
|
|
@@ -29909,10 +29914,15 @@ function startTask(hit, message, sessionId) {
|
|
|
29909
29914
|
error: ""
|
|
29910
29915
|
};
|
|
29911
29916
|
tasks.set(id, task);
|
|
29917
|
+
if (dedupeKey) runningByKey.set(dedupeKey, task);
|
|
29912
29918
|
pruneTasks();
|
|
29913
29919
|
log(`task ${id} \u2192 ${hit.name}(${hit.agent_type}) session=${sessionId || "\u65B0\u4F1A\u8BDD"}`);
|
|
29920
|
+
const releaseKey = () => {
|
|
29921
|
+
if (task.key && runningByKey.get(task.key) === task) runningByKey.delete(task.key);
|
|
29922
|
+
};
|
|
29914
29923
|
executeRun(hit, message, sessionId).then((r) => {
|
|
29915
29924
|
task.finished_ms = Date.now();
|
|
29925
|
+
releaseKey();
|
|
29916
29926
|
if (r.ok) {
|
|
29917
29927
|
task.status = "done";
|
|
29918
29928
|
task.result = r;
|
|
@@ -29928,6 +29938,7 @@ function startTask(hit, message, sessionId) {
|
|
|
29928
29938
|
}
|
|
29929
29939
|
}).catch((e) => {
|
|
29930
29940
|
task.finished_ms = Date.now();
|
|
29941
|
+
releaseKey();
|
|
29931
29942
|
task.status = "failed";
|
|
29932
29943
|
task.error = e?.name === "TimeoutError" ? `\u5B50\u667A\u80FD\u4F53\u8D85\u8FC7 ${RUN_TIMEOUT_MS / 1e3}s \u672A\u8FD4\u56DE` : e?.message ?? String(e);
|
|
29933
29944
|
log(`task ${id} ERROR: ${task.error}`);
|
|
@@ -29983,18 +29994,22 @@ function renderPending(task) {
|
|
|
29983
29994
|
function createMcpServer() {
|
|
29984
29995
|
const server = new McpServer(
|
|
29985
29996
|
{ name: "mapp-router-probe", version: SERVER_VERSION },
|
|
29986
|
-
{ instructions:
|
|
29997
|
+
{ instructions: `\u5E94\u7528\u8DEF\u7531 MCP\uFF1A\u5148 list_apps \u627E\u5019\u9009\uFF08\u542B\u5E7F\u573A\u5E94\u7528\u4E0E\u5979\u81EA\u5EFA\u7684\u5E94\u7528\uFF09\uFF0C\u518D run_app \u628A\u4EFB\u52A1\u8F6C\u4EA4\u7ED9\u9009\u4E2D\u7684\u667A\u80FD\u4F53\uFF1B\u6E05\u5355\u672C\u8EAB\u4E0D\u662F\u7B54\u6848\u3002run_app \u82E5\u53EA\u56DE task_id\uFF0C\u8BF4\u660E\u5B50\u667A\u80FD\u4F53\u8FD8\u5728\u8DD1\uFF0C\u7528 fetch_run_result(task_id) \u8F6E\u8BE2\u53D6\u7ED3\u679C\uFF08\u8FD9\u4E2A\u5DE5\u5177\u4F1A\u81EA\u5DF1\u7B49\u6700\u591A\u7EA6 ${Math.round(FETCH_WAIT_MS / 1e3)} \u79D2\uFF0C\u56DE\u300C\u4EFB\u52A1\u672A\u5B8C\u6210\u300D\u5C31\u7ACB\u523B\u518D\u67E5\u4E00\u6B21\uFF09\uFF0C\u4E0D\u8981\u91CD\u590D\u63D0\u4EA4\u3002mcp_probe \u4EC5\u7528\u4E8E\u9A8C\u8BC1\u901A\u9053\u3002` }
|
|
29987
29998
|
);
|
|
29988
29999
|
server.registerTool(
|
|
29989
30000
|
"mcp_probe",
|
|
29990
30001
|
{
|
|
29991
30002
|
title: "\u8FDE\u901A\u6027\u63A2\u9488",
|
|
29992
|
-
description: "\u56DE\u663E\u672C MCP \u670D\u52A1\u7684\u8FD0\u884C\u8EAB\u4EFD\uFF08\u4E3B\u673A\u3001\u7AEF\u53E3\u3001\u542F\u52A8\u65F6\u95F4\u3001\u88AB\u8C03\u7528\u6B21\u6570\uFF09\u3002\u7528\u4E8E\u9A8C\u8BC1\u5E73\u53F0\u4FA7\u8FD0\u884C\u65F6\u80FD\u5426\u771F\u6B63\u8FDE\u5230\u672C\u670D\u52A1\uFF0C\u4E0D\u6D89\u53CA\u4EFB\u4F55\u4E1A\u52A1\u3002",
|
|
29993
|
-
inputSchema: {
|
|
30003
|
+
description: "\u56DE\u663E\u672C MCP \u670D\u52A1\u7684\u8FD0\u884C\u8EAB\u4EFD\uFF08\u4E3B\u673A\u3001\u7AEF\u53E3\u3001\u542F\u52A8\u65F6\u95F4\u3001\u88AB\u8C03\u7528\u6B21\u6570\uFF09\u3002\u7528\u4E8E\u9A8C\u8BC1\u5E73\u53F0\u4FA7\u8FD0\u884C\u65F6\u80FD\u5426\u771F\u6B63\u8FDE\u5230\u672C\u670D\u52A1\uFF0C\u4E0D\u6D89\u53CA\u4EFB\u4F55\u4E1A\u52A1\u3002\u5E26 sleep_ms \u65F6\u5148\u539F\u5730\u7B49\u8FD9\u4E48\u591A\u6BEB\u79D2\u518D\u56DE\uFF1A\u4E13\u95E8\u7528\u6765\u91CF\u5E73\u53F0\u5355\u6B21\u5DE5\u5177\u8C03\u7528\u7684\u771F\u5B9E\u4E0A\u9650\uFF08\u4E0D\u63D0\u4EA4\u4EFB\u4F55\u4EFB\u52A1\uFF0C\u6390\u65AD\u4E5F\u6CA1\u6709\u526F\u4F5C\u7528\uFF09\u3002",
|
|
30004
|
+
inputSchema: {
|
|
30005
|
+
note: external_exports.string().describe("\u4EFB\u610F\u6587\u672C\uFF0C\u4F1A\u539F\u6837\u56DE\u663E").optional(),
|
|
30006
|
+
sleep_ms: external_exports.number().int().min(1).max(6e4).describe("\u5148\u7B49 N \u6BEB\u79D2\u518D\u56DE\uFF0C\u7528\u6765\u6D4B\u5E73\u53F0\u5355\u6B21\u5DE5\u5177\u8C03\u7528\u7684\u8D85\u65F6\u4E0A\u9650").optional()
|
|
30007
|
+
}
|
|
29994
30008
|
},
|
|
29995
|
-
async ({ note }) => {
|
|
30009
|
+
async ({ note, sleep_ms }) => {
|
|
29996
30010
|
callCount += 1;
|
|
29997
|
-
recentCalls.push(`mcp_probe${note ? `(${note})` : ""}`);
|
|
30011
|
+
recentCalls.push(`mcp_probe${note ? `(${note})` : ""}${sleep_ms ? `+${sleep_ms}ms` : ""}`);
|
|
30012
|
+
if (sleep_ms) await new Promise((r) => setTimeout(r, Math.min(6e4, Math.max(1, sleep_ms))));
|
|
29998
30013
|
const text = [
|
|
29999
30014
|
"MCP \u901A\u9053\u8FDE\u901A\u3002\u4EE5\u4E0B\u4E3A\u670D\u52A1\u7AEF\u4FE1\u606F\uFF1A",
|
|
30000
30015
|
/**
|
|
@@ -30093,7 +30108,7 @@ function createMcpServer() {
|
|
|
30093
30108
|
"run_app",
|
|
30094
30109
|
{
|
|
30095
30110
|
title: "\u8F6C\u4EA4\u4EFB\u52A1\u7ED9\u5E94\u7528",
|
|
30096
|
-
description:
|
|
30111
|
+
description: `\u628A\u4E00\u6BB5\u5B8C\u6574\u3001\u53EF\u72EC\u7ACB\u7406\u89E3\u7684\u4EFB\u52A1\u8F6C\u4EA4\u7ED9\u67D0\u4E2A\u667A\u80FD\u4F53\u6216\u56E2\u961F\u6267\u884C \u2014\u2014 \u5E7F\u573A\u5E94\u7528\u548C\u5979\u81EA\u5DF1\u5728\u5E73\u53F0\u4E0A\u5EFA\u7684\u5E94\u7528\u90FD\u5728\u5019\u9009\u91CC\u3002\u5F53\u573A\u6700\u591A\u7B49\u7EA6 ${Math.round(RUN_INLINE_WAIT_MS / 1e3)} \u79D2\uFF1A\u8DD1\u5F97\u5B8C\u5C31\u76F4\u63A5\u8FD4\u56DE\u5B83\u7684\u56DE\u7B54\uFF1B\u8DD1\u4E0D\u5B8C\u4F1A\u8FD4\u56DE\u300C\u4EFB\u52A1\u672A\u5B8C\u6210\u300D+ task_id\uFF0C\u8FD9\u65F6\u6539\u7528 fetch_run_result(task_id) \u53D6\u7ED3\u679C\uFF0C\u7EDD\u5BF9\u4E0D\u8981\u4E3A\u4E86\u62FF\u7ED3\u679C\u91CD\u590D\u8C03\u7528\u672C\u5DE5\u5177\uFF08\u90A3\u7B49\u4E8E\u8BA9\u5B50\u667A\u80FD\u4F53\u628A\u540C\u4E00\u4EF6\u4E8B\u518D\u505A\u4E00\u904D\uFF09\u3002app_id \u5FC5\u987B\u6765\u81EA list_apps \u8FD4\u56DE\u7684 id\uFF1B\u540C\u4E00\u5E94\u7528\u8981\u7EE7\u7EED\u804A\uFF0C\u5E26\u4E0A\u4E0A\u6B21 run_app \u8FD4\u56DE\u7684 session_id\u3002\u4EFB\u52A1\u6D89\u53CA\u7528\u6237\u4E0A\u4F20\u7684\u9644\u4EF6\u65F6\uFF0C\u628A\u6587\u4EF6\u8DEF\u5F84\u653E\u8FDB file_paths\uFF08\u5F62\u5982 /work_xxxx/\u6587\u4EF6\u540D\uFF0C\u6216\u53EA\u5199\u6587\u4EF6\u540D\uFF09\uFF0C\u670D\u52A1\u7AEF\u4F1A\u628A\u6587\u4EF6\u76F4\u63A5\u653E\u8FDB\u5B50\u667A\u80FD\u4F53\u81EA\u5DF1\u7684\u5DE5\u4F5C\u76EE\u5F55\uFF1B**\u4E0D\u8981\u628A\u6574\u4EFD\u8868\u683C\u5185\u5BB9\u6284\u8FDB message**\u3002`,
|
|
30097
30112
|
inputSchema: {
|
|
30098
30113
|
app_id: external_exports.string().describe("list_apps \u8FD4\u56DE\u7684\u76EE\u6807\u5E94\u7528 id"),
|
|
30099
30114
|
message: external_exports.string().describe("\u8F6C\u4EA4\u7ED9\u8BE5\u5E94\u7528\u7684\u5B8C\u6574\u4EFB\u52A1\u63CF\u8FF0\uFF08\u542B\u7528\u6237\u7ED9\u7684\u539F\u6587\u4E0E\u5FC5\u8981\u4E0A\u4E0B\u6587\uFF09\uFF0C\u4E0D\u8981\u53EA\u4E22\u5173\u952E\u8BCD\uFF1B\u6709\u6587\u4EF6\u65F6\u4E0D\u7528\u590D\u8FF0\u6587\u4EF6\u5185\u5BB9"),
|
|
@@ -30120,6 +30135,22 @@ function createMcpServer() {
|
|
|
30120
30135
|
true
|
|
30121
30136
|
);
|
|
30122
30137
|
}
|
|
30138
|
+
const dedupeKey = taskKeyOf(app_id, session_id, message, file_paths);
|
|
30139
|
+
const existing = runningByKey.get(dedupeKey);
|
|
30140
|
+
if (existing) {
|
|
30141
|
+
log(`run_app dedupe hit \u2192 ${existing.id}`);
|
|
30142
|
+
const done2 = await waitForTask(existing, RUN_INLINE_WAIT_MS);
|
|
30143
|
+
if (!done2) {
|
|
30144
|
+
return textContent(
|
|
30145
|
+
`${renderPending(existing)}
|
|
30146
|
+
\uFF08\u540C\u4E00\u4E2A\u8BF7\u6C42\u6B63\u5728\u6267\u884C\uFF0C\u5DF2\u5408\u5E76\u5230 task_id=${existing.id}\uFF0C\u6CA1\u6709\u91CD\u65B0\u63D0\u4EA4\uFF09`
|
|
30147
|
+
);
|
|
30148
|
+
}
|
|
30149
|
+
if (existing.status === "failed") {
|
|
30150
|
+
return textContent(`\u8C03\u7528\u300C${existing.app_name}\u300D\u5931\u8D25\uFF1A${existing.error}`, true);
|
|
30151
|
+
}
|
|
30152
|
+
return textContent(renderDone(existing));
|
|
30153
|
+
}
|
|
30123
30154
|
let finalMessage = message;
|
|
30124
30155
|
if (Array.isArray(file_paths) && file_paths.length > 0) {
|
|
30125
30156
|
const uid = (hit.uid ?? "").trim() || processUid();
|
|
@@ -30153,7 +30184,7 @@ function createMcpServer() {
|
|
|
30153
30184
|
|
|
30154
30185
|
` + message;
|
|
30155
30186
|
}
|
|
30156
|
-
const task = startTask(hit, finalMessage, session_id);
|
|
30187
|
+
const task = startTask(hit, finalMessage, session_id, dedupeKey);
|
|
30157
30188
|
const done = await waitForTask(task, RUN_INLINE_WAIT_MS);
|
|
30158
30189
|
if (!done) return textContent(renderPending(task));
|
|
30159
30190
|
if (task.status === "failed") {
|