@kuluomi/mapp-router-mcp 0.0.0-stage → 0.3.2

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.
Files changed (3) hide show
  1. package/README.md +66 -2
  2. package/package.json +20 -4
  3. package/server.mjs +30209 -0
package/README.md CHANGED
@@ -1,3 +1,67 @@
1
- # Temporary Holding Version
1
+ # mapp-router-mcp
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ MAPP 平台的意图路由 MCP 服务。超级agent(元小智)用它先列出可转交的应用、再把任务转交给选中的那个应用执行。
4
+
5
+ 这个包是 `mapp_assembler/mcp-router-probe/server.mjs` 的**零依赖单文件版**:`server.mjs` 里已经把 MCP SDK 一起打进去了,所以拿到它只要有 node 就能跑,不需要 `npm install`,也没有 `node_modules`。这是它能被 `npx git+https://…` 这种方式直接拉起的前提。
6
+
7
+ 改逻辑请改上面那份源文件,然后重新打包,别直接改这里的 `server.mjs`。
8
+ **别再加 `--banner:js='#!/usr/bin/env node'`**:源文件的第 1 行已经有 shebang,esbuild 会原样保留,
9
+ 再加一条 banner 就变成两行 shebang,node 第 2 行直接报 `SyntaxError: Invalid or unexpected token`。
10
+
11
+ ```sh
12
+ node_modules/.bin/esbuild mcp-router-probe/server.mjs \
13
+ --bundle --platform=node --format=esm --target=node18 \
14
+ --outfile=mcp-router-mcp/server.mjs
15
+ ```
16
+
17
+ ## 两种运行形态
18
+
19
+ | 形态 | 命令 | 谁在用 |
20
+ | --- | --- | --- |
21
+ | stdio | `node server.mjs --stdio` | 客户端在自己机器上拉起进程,比如平台配 MCP 填 command 那种 |
22
+ | HTTP | `node server.mjs`(默认 5173) | 需要一个能被访问到的网址时的形态;端点是 `/mcp`,探活是 `/healthz` |
23
+
24
+ stdio 形态下 stdout 只走协议帧,所有日志走 stderr。HTTP 形态下 `/healthz` 免鉴权,其余要 `Authorization: Bearer <MCP_PROBE_TOKEN>`。
25
+
26
+ ## 提供四个工具
27
+
28
+ `mcp_probe` 回显运行身份,用来验证通道通不通。`list_apps` 拉候选应用(应用广场的 agent / team,加上账号自己在平台上建的应用)。`run_app` 把一段完整任务转交给选中的应用,当场最多等约 8.5 秒,超时就回 `task_id`。`fetch_run_result` 按 `task_id` 取结果,每次调用自己阻塞最多约 8 秒 —— 等待放在工具里,而不是让模型多问几遍(每问一遍都是一整次模型回合)。
29
+
30
+ ## 环境变量
31
+
32
+ | 变量 | 必填 | 作用 |
33
+ | --- | --- | --- |
34
+ | `MAPP_ACCESS_TOKEN` | 转交任务和「我的应用」那一路要 | 平台签发的 access-token,决定能以谁的身份提交任务 |
35
+ | `MCP_PROBE_TOKEN` | 仅 HTTP 形态 | 访问 `/mcp` 的 Bearer;不配就是不鉴权,别把它挂到代理域名上 |
36
+ | `MCP_STDIO` | 否 | 置 `1` 等价于命令行加 `--stdio` |
37
+ | `ROUTER_PORT` | 否 | HTTP 端口,默认 5173 |
38
+ | `ROUTER_EXCLUDE_IDS` | 否 | 逗号分隔的 app_id,从候选清单里摘掉 |
39
+ | `ROUTER_OWNER_USER_ID` | 否 | 应用归属判定用的账号 uid;不配就从个人空间那几条自己认 |
40
+ | `MCP_RUN_INLINE_WAIT_MS` / `MCP_FETCH_WAIT_MS` | 否 | `run_app` 当场等待与 `fetch_run_result` 单次阻塞的上限,默认 8500 / 8000 ms,必须留在平台那 10 秒以内 |
41
+ | `MCP_ANSWER_MAX_CHARS` / `MCP_CONFIG_PASS_MAX_CHARS` | 否 | 回答进模型上下文的上限,默认 12000;带 ```agent-config / ```team-config 的回答改用后一个(默认 20000),截断会让前端那张确认卡片解析不出来 |
42
+
43
+ `MAPP_ACCESS_TOKEN` 缺了不影响 `mcp_probe` 和广场那半份清单,只是「我的应用」和 `run_app` 会明确报缺密钥。本地开发时它也可以不配——进程会退回到读同仓库 `.env.development` 里的 `VITE_MARKETPLACE_ACCESS_TOKEN`(那个文件在 gitignore 里,不会跟着仓库出去)。
44
+
45
+ ## 在平台侧配 stdio
46
+
47
+ 把本仓库推到公司 git 之后,配置大致长这样(令牌用**只读**的那把,别用 access-token 冒充):
48
+
49
+ ```json
50
+ {
51
+ "type": "stdio",
52
+ "name": "mapp-router",
53
+ "command": "npx",
54
+ "args": ["-y", "git+https://<只读令牌>@git.<公司域名>/<组>/mapp-router-mcp.git"],
55
+ "env": {
56
+ "MAPP_ACCESS_TOKEN": "<平台签发的 access-token>"
57
+ }
58
+ }
59
+ ```
60
+
61
+ 三个已知前提,配之前值得先确认:执行环境能连到公司 git 服务;那台机器上有 `git`;`npx` 走的是默认 registry 或你们私服。任何一个不满足,就退回 HTTP 形态。
62
+
63
+ ## 两条要注意的
64
+
65
+ **密钥明文存在平台配置里。** 上面那个 `env` 块是明文保存的,而且这类 MCP 配置能被读回来(工具库里那条 wigolo 的 Bearer 就是这么被原样取出的)。不想接受这个代价,就继续用 HTTP 形态——那种情况下密钥只在自己机器上。
66
+
67
+ **stdio 每次都是冷启。** 进程用完就关,注册表缓存随之没了,第一次 `list_apps` 会慢(本地实测首次约 2.7 秒,缓存后约 0.6 秒)。平台侧单次工具调用的等待窗口大约 10 秒,有余量但比 HTTP 窄,改超时参数时记着这个数。
package/package.json CHANGED
@@ -1,6 +1,22 @@
1
1
  {
2
2
  "name": "@kuluomi/mapp-router-mcp",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.3.2",
4
+ "description": "MAPP 平台意图路由 MCP 服务:列出可转交的应用,并把任务转交给它们。单文件、零运行时依赖。",
5
+ "type": "module",
6
+ "bin": {
7
+ "mapp-router-mcp": "server.mjs"
8
+ },
9
+ "files": [
10
+ "server.mjs",
11
+ "README.md"
12
+ ],
13
+ "engines": {
14
+ "node": ">=18"
15
+ },
16
+ "scripts": {
17
+ "start": "node server.mjs --stdio",
18
+ "start:http": "node server.mjs"
19
+ },
20
+ "license": "UNLICENSED",
21
+ "private": false
22
+ }