@miaocedata/mbi-bi-mcp 0.2.3 → 0.2.4
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 +17 -1
- package/package.json +1 -1
- package/src/auth.js +6 -3
- package/src/client.js +4 -3
- package/src/index.js +1 -1
package/README.md
CHANGED
|
@@ -81,6 +81,22 @@ MBI_PLATFORM_URL = "https://bi.example.com"
|
|
|
81
81
|
|
|
82
82
|
⚠️ 打开私网 HTTP 后,`Authorization: Bearer bimcp_...` 会以明文经过内网,同网段的任何人都能抓包并复用这枚 7 天有效的只读令牌,读走整个租户的 App、指标与业务本体。仅在物理/逻辑隔离的内网启用,并优先给内网服务补一层 HTTPS 反代。市场表单不提供这个开关,需要用户在宿主 `mcp.json` 里自行添加。
|
|
83
83
|
|
|
84
|
+
**门户只有 http 域名时**(内网穿透把内网服务映射成一个 http 域名,例如花生壳的 `http://97zj0061no79.vicp.fun:57101`),上面两个开关都不覆盖,因为整个主机名既不是本机也不是私网 IP。此时设置 `MBI_ALLOW_INSECURE_HTTP=true`,它对任意主机名/IP 的 http 地址放行。
|
|
85
|
+
|
|
86
|
+
```json
|
|
87
|
+
{
|
|
88
|
+
"env": {
|
|
89
|
+
"MBI_PLATFORM_URL": "http://97zj0061no79.vicp.fun:57101",
|
|
90
|
+
"MBI_ALLOW_INSECURE_HTTP": "true",
|
|
91
|
+
"MBI_API_BASE_PATH": "/prod-api"
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
⚠️ 这是范围最大的开关:任何 http 地址(含公网)都会被放行,令牌与业务数据全程明文。只应在临时联调或客户明确接受风险的内网穿透场景使用,长期部署请换成 HTTPS 域名。
|
|
97
|
+
|
|
98
|
+
三个开关互不影响,只按"地址是否命中各自的放行条件"判断:`MBI_ALLOW_INSECURE_LOCALHOST` → 仅本机主机名;`MBI_ALLOW_INSECURE_PRIVATE_NETWORK` → 仅 RFC1918 / IPv6 ULA;`MBI_ALLOW_INSECURE_HTTP` → 任意 http 主机。
|
|
99
|
+
|
|
84
100
|
首次调用工具会打开浏览器。用中台账号登录,确认租户并点击批准,看到成功提示后在宿主重试同一工具。连接器把令牌缓存到本机用户目录 `~/.mbi-bi/grant.json`(POSIX 上以 0600 权限创建;Windows 位于当前用户配置文件目录下),令牌初始有效期为 7 天,并在每次成功使用时自动重新计算 7 天;进程重启后自动从该文件恢复未过期令牌。只有连续 7 天未使用或服务端判定失效(401)时才重新授权并要求批准。用户可以在门户 `/external-bi/connections` 撤销当前账号在当前租户下的全部 BI MCP 连接;撤销后本地缓存会在下一次请求被服务端拒绝时清除。连接器不要求提供中台密码或 Web token。
|
|
85
101
|
|
|
86
102
|
用户要换账号、换租户,或怀疑缓存令牌已经失效时,让 Agent 调用 `reauthorize`(无参数):它尽力撤销服务端令牌、删除本机缓存 `~/.mbi-bi/grant.json`,并立刻打开新的授权页;工具本身立即返回,不阻塞对话。用户在浏览器里批准后,重新调用目标工具即可。手工删除 `~/.mbi-bi/grant.json` 效果相同,但下一次工具调用仍会自动打开浏览器。注意授权回调只监听 127.0.0.1 的随机端口、等待 300 秒(5 分钟),宿主配置里的 `timeout` 必须大于这个窗口(建议 360000 或更大),否则进程会被提前结束、浏览器只剩 `ERR_CONNECTION_REFUSED`。
|
|
@@ -101,7 +117,7 @@ MBI_PLATFORM_URL = "https://bi.example.com"
|
|
|
101
117
|
|
|
102
118
|
## 打包与上架
|
|
103
119
|
|
|
104
|
-
运行 `npm pack --dry-run` 检查文件,再运行 `npm publish --access public` 发布到 `@miaocedata/mbi-bi-mcp@0.2.
|
|
120
|
+
运行 `npm pack --dry-run` 检查文件,再运行 `npm publish --access public` 发布到 `@miaocedata/mbi-bi-mcp@0.2.4`(发布前需在 npmjs.com 拥有 `miaocedata` 组织,否则会报 `404 Scope not found`),市场包用 `connector/mcp.json` 里固定的版本号启动。`connector/mcp.json` 的 `npmRegistries` 按 `registry.npmjs.org` → `registry.npmmirror.com` 顺序回退:npm 官方仓库是权威源,国内镜像只做兜底,避免只配镜像时新版本尚未同步导致 `npx` 404。后续每次升级必须先递增 `package.json` 的版本号再发布,并同步修改 `connector/mcp.json` 与 `connector/connector-meta.json` 里的版本号;只向 WorkBuddy 提交所需连接器材料,不把中台服务、Python connector、客户地址或任何凭证打进市场包。
|
|
105
121
|
|
|
106
122
|
> **提审前须知(本地定制)**:当前 `src/client.js` 将滑动 7 天令牌持久化到本机用户目录(`~/.mbi-bi/grant.json`),目的是避免宿主关闭或每轮对话重启进程后反复授权。令牌文件不在本包目录内,不会随 `npm pack` 进入市场包;但长期凭据落盘属于安全敏感行为,正式提审前须重新评估是否接受。若需恢复短时令牌设计,用同目录的 `src/client.js.bak` 覆盖 `src/client.js`,并把上面的有效期说明同步改回。
|
|
107
123
|
|
package/package.json
CHANGED
package/src/auth.js
CHANGED
|
@@ -145,9 +145,12 @@ export function platformUrls(env) {
|
|
|
145
145
|
const loopback = LOOPBACK_HOSTS.includes(base.hostname);
|
|
146
146
|
const allowLocalhost = loopback && env.MBI_ALLOW_INSECURE_LOCALHOST === 'true';
|
|
147
147
|
const allowPrivate = env.MBI_ALLOW_INSECURE_PRIVATE_NETWORK === 'true' && isPrivateNetworkHost(base.hostname);
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
148
|
+
// 内网穿透/映射场景下门户只有 http 域名(例如花生壳的 *.vicp.fun),用这个开关整体放行
|
|
149
|
+
const allowAnyHost = env.MBI_ALLOW_INSECURE_HTTP === 'true';
|
|
150
|
+
if (!allowLocalhost && !allowPrivate && !allowAnyHost) {
|
|
151
|
+
throw new Error('Insecure HTTP requires MBI_ALLOW_INSECURE_LOCALHOST=true for localhost, '
|
|
152
|
+
+ 'MBI_ALLOW_INSECURE_PRIVATE_NETWORK=true for private network hosts, '
|
|
153
|
+
+ 'or MBI_ALLOW_INSECURE_HTTP=true for any host');
|
|
151
154
|
}
|
|
152
155
|
}
|
|
153
156
|
if (base.username || base.password || !/^\/(?:[A-Za-z0-9_-]+\/)*[A-Za-z0-9_-]*$/.test(base.pathname)) throw new Error('Invalid MBI_PLATFORM_URL');
|
package/src/client.js
CHANGED
|
@@ -313,7 +313,8 @@ export class PlatformSession {
|
|
|
313
313
|
#unavailableMessage() {
|
|
314
314
|
if (typeof this.#configError === 'string' && this.#configError.includes('Insecure HTTP')) {
|
|
315
315
|
return '数据中台地址是 HTTP,明文传输默认被拒绝:本机地址需设置 MBI_ALLOW_INSECURE_LOCALHOST=true,'
|
|
316
|
-
+ '
|
|
316
|
+
+ '内网 IP 需设置 MBI_ALLOW_INSECURE_PRIVATE_NETWORK=true,'
|
|
317
|
+
+ '内网穿透等只有 http 域名的场景需设置 MBI_ALLOW_INSECURE_HTTP=true,或改用 HTTPS 门户地址。';
|
|
317
318
|
}
|
|
318
319
|
return '尚未配置数据中台地址。请让用户明确提供门户地址,再调用 configure_platform。';
|
|
319
320
|
}
|
|
@@ -375,8 +376,8 @@ export class PlatformSession {
|
|
|
375
376
|
if (!next) {
|
|
376
377
|
if (typeof reason === 'string' && reason.includes('Insecure HTTP')) {
|
|
377
378
|
return error('INVALID_ARGUMENT', '数据中台地址是 HTTP,明文传输默认被拒绝:本机地址需设置 '
|
|
378
|
-
+ 'MBI_ALLOW_INSECURE_LOCALHOST=true
|
|
379
|
-
+ '
|
|
379
|
+
+ 'MBI_ALLOW_INSECURE_LOCALHOST=true,内网 IP 需设置 MBI_ALLOW_INSECURE_PRIVATE_NETWORK=true,'
|
|
380
|
+
+ '内网穿透等只有 http 域名的场景需设置 MBI_ALLOW_INSECURE_HTTP=true,或改用 HTTPS 门户地址。');
|
|
380
381
|
}
|
|
381
382
|
return error('INVALID_ARGUMENT', '数据中台地址无效;正式环境必须是 HTTPS 门户地址。');
|
|
382
383
|
}
|
package/src/index.js
CHANGED
|
@@ -6,7 +6,7 @@ import { PlatformSession, tools } from './client.js';
|
|
|
6
6
|
|
|
7
7
|
async function main() {
|
|
8
8
|
const session = new PlatformSession(process.env);
|
|
9
|
-
const server = new Server({ name: 'mbi-senseX', version: '0.2.
|
|
9
|
+
const server = new Server({ name: 'mbi-senseX', version: '0.2.4' }, { capabilities: { tools: {} } });
|
|
10
10
|
server.setRequestHandler(ListToolsRequestSchema, () => ({ tools }));
|
|
11
11
|
server.setRequestHandler(CallToolRequestSchema, ({ params }) => session.call(params.name, params.arguments));
|
|
12
12
|
server.onerror = () => console.error('[mbi-senseX-mcp] MCP protocol error.');
|