@quantod/qq 1.0.2 → 1.0.3
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/dist/mcp.d.ts.map +1 -1
- package/dist/mcp.js +23 -10
- package/dist/mcp.js.map +1 -1
- package/dist/resources/guide.md +2 -2
- package/package.json +1 -1
- package/src/mcp.ts +21 -11
package/dist/mcp.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AA0DA,wBAAsB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiLhE"}
|
package/dist/mcp.js
CHANGED
|
@@ -13,6 +13,7 @@ const http_js_1 = require("./http.js");
|
|
|
13
13
|
const javascript_js_1 = require("./sdk-templates/javascript.js");
|
|
14
14
|
const python_js_1 = require("./sdk-templates/python.js");
|
|
15
15
|
const VERSION = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, '../package.json'), 'utf8')).version;
|
|
16
|
+
const RESOURCES = ['guide', 'chrome', 'pipeline_design'];
|
|
16
17
|
function loadResource(name) {
|
|
17
18
|
return (0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, 'resources', `${name}.md`), 'utf8');
|
|
18
19
|
}
|
|
@@ -121,7 +122,7 @@ async function startMcp(fixedPort) {
|
|
|
121
122
|
inputSchema: { pipeline: zod_1.z.string() },
|
|
122
123
|
}, ({ pipeline }) => {
|
|
123
124
|
try {
|
|
124
|
-
return ok((0, js_yaml_1.dump)((0, commands_js_1.status)(pipeline), { lineWidth: -1 }));
|
|
125
|
+
return ok((0, js_yaml_1.dump)((0, commands_js_1.status)(pipeline), { lineWidth: -1, flowLevel: 2 }));
|
|
125
126
|
}
|
|
126
127
|
catch (e) {
|
|
127
128
|
return err(e);
|
|
@@ -214,16 +215,28 @@ async function startMcp(fixedPort) {
|
|
|
214
215
|
return err(e);
|
|
215
216
|
}
|
|
216
217
|
});
|
|
218
|
+
server.registerTool('resource_read', {
|
|
219
|
+
description: `Read a QQ documentation resource by name. Use this tool if your environment cannot read MCP resources directly.
|
|
220
|
+
|
|
221
|
+
Available resources:
|
|
222
|
+
- guide — Complete reference: mental model, all MCP tools with parameters/returns/errors, SDK usage examples. Read this before using any QQ tool.
|
|
223
|
+
- pipeline_design — Step-by-step pipeline design guide: how to design stages, write PIPELINES.md, and run the pre-implementation checklist.
|
|
224
|
+
- chrome — Chrome browser automation patterns for QQ pipelines: tab reuse, script injection, progress monitoring.`,
|
|
225
|
+
inputSchema: { resource: zod_1.z.enum(RESOURCES) },
|
|
226
|
+
}, ({ resource }) => {
|
|
227
|
+
try {
|
|
228
|
+
return ok(loadResource(resource));
|
|
229
|
+
}
|
|
230
|
+
catch (e) {
|
|
231
|
+
return err(e);
|
|
232
|
+
}
|
|
233
|
+
});
|
|
217
234
|
// ── Resources ──────────────────────────────────────────────────────────────
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
}));
|
|
224
|
-
server.registerResource('pipeline_design', new mcp_js_1.ResourceTemplate('qq://pipeline_design', { list: undefined }), { mimeType: 'text/markdown' }, async () => ({
|
|
225
|
-
contents: [{ uri: 'qq://pipeline_design', mimeType: 'text/markdown', text: loadResource('pipeline_design') }],
|
|
226
|
-
}));
|
|
235
|
+
for (const name of RESOURCES) {
|
|
236
|
+
server.registerResource(name, new mcp_js_1.ResourceTemplate(`qq://${name}`, { list: undefined }), { mimeType: 'text/markdown' }, async () => ({
|
|
237
|
+
contents: [{ uri: `qq://${name}`, mimeType: 'text/markdown', text: loadResource(name) }],
|
|
238
|
+
}));
|
|
239
|
+
}
|
|
227
240
|
// ── Connect ────────────────────────────────────────────────────────────────
|
|
228
241
|
const transport = new stdio_js_1.StdioServerTransport();
|
|
229
242
|
await server.connect(transport);
|
package/dist/mcp.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":";;AA0DA,4BAiLC;AA3OD,oEAAsF;AACtF,wEAAiF;AACjF,qCAAuC;AACvC,yCAAiC;AACjC,qCAA4C;AAC5C,6BAAwB;AACxB,qCAA+B;AAC/B,+CAGuB;AACvB,uCAAsC;AACtC,iEAAoE;AACpE,yDAA4D;AAE5D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CACxB,IAAA,sBAAY,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,CACzD,CAAC,OAAiB,CAAC;AAEpB,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,iBAAiB,CAAU,CAAC;AAGlE,SAAS,YAAY,CAAC,IAAc;IAClC,OAAO,IAAA,sBAAY,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,YAAY,GAAG;;;;;;;;;;+GAU0F,CAAC;AAEhH,SAAS,QAAQ;IACf,MAAM,MAAM,GAAG,IAAA,2BAAiB,GAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QACpC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACvC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ;gBAAE,OAAO,KAAK,CAAC,OAAO,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,EAAE,CAAC,IAAY;IACtB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,SAAS,GAAG,CAAC,CAAU;IACrB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,GAAG,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACxF,CAAC;AAEM,KAAK,UAAU,QAAQ,CAAC,SAAkB;IAC/C,MAAM,IAAI,GAAG,MAAM,IAAA,mBAAS,EAAC,SAAS,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IAEzB,MAAM,MAAM,GAAG,IAAI,kBAAS,CAC1B,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAChC,EAAE,YAAY,EAAE,YAAY,EAAE,CAC/B,CAAC;IAEF,8EAA8E;IAE9E,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE;QACnC,WAAW,EAAE,iDAAiD;QAC9D,WAAW,EAAE,EAAE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;KACjF,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE;QAC3B,IAAI,CAAC;YAAC,OAAO,EAAE,CAAC,aAAa,IAAA,0BAAY,EAAC,IAAI,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;QAAC,CAAC;QAClE,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE;QAC1B,WAAW,EAAE,8DAA8D;QAC3E,WAAW,EAAE;YACX,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;YACpB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC5B,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACzB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/B,aAAa,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC3D;KACF,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,EAAE;QAC/D,IAAI,CAAC;YAAC,OAAO,EAAE,CAAC,OAAO,IAAA,kBAAI,EAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;QAAC,CAAC;QAC5F,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;QAC3B,WAAW,EAAE,+EAA+E;QAC5F,WAAW,EAAE;YACX,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;YACpB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;YAC9B,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACzB,MAAM,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAC/B;KACF,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACrC,IAAI,CAAC;YAAC,OAAO,EAAE,CAAC,IAAA,cAAI,EAAC,IAAA,mBAAK,EAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAAC,CAAC;QACnF,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE;QAC7B,WAAW,EAAE,uFAAuF;QACpG,WAAW,EAAE;YACX,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;YACpB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;YACf,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC7B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC/B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/B,aAAa,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC3D;KACF,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,EAAE;QAC1E,IAAI,CAAC;YAAC,IAAA,qBAAO,EAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAC;YAAC,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC;QAAC,CAAC;QAC7G,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE;QAC5B,WAAW,EAAE,8EAA8E;QAC3F,WAAW,EAAE,EAAE,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE;KACtC,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;QAClB,IAAI,CAAC;YAAC,OAAO,EAAE,CAAC,IAAA,cAAI,EAAC,IAAA,oBAAM,EAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAAC,CAAC;QAC3E,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE;QAChC,WAAW,EAAE,6EAA6E;QAC1F,WAAW,EAAE;YACX,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;YACpB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC5B,cAAc,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YACtC,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC/B,GAAG,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YACnC,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACnC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACpC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACpC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC5B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC9B;KACF,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QAClH,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAA,uBAAS,EAAC,QAAQ,EAAE,KAAK,IAAI,GAAG,EAAE;gBAC9C,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa;gBACxE,cAAc,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM;aAC7C,EAAE,cAAc,IAAI,KAAK,CAAC,CAAC;YAC5B,OAAO,EAAE,CAAC,IAAA,cAAI,EAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE;QAC7B,WAAW,EAAE,+EAA+E;QAC5F,WAAW,EAAE;YACX,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;YACpB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC5B,GAAG,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YACnC,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACnC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACpC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACrC;KACF,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,EAAE,EAAE;QAC1E,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAA,qBAAO,EAAC,QAAQ,EAAE,KAAK,IAAI,GAAG,EAAE;gBACxC,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa;aAC/F,CAAC,CAAC;YACH,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,iBAAiB,EAAE;QACrC,WAAW,EAAE,6EAA6E;QAC1F,WAAW,EAAE,EAAE,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE;KACtC,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;QAClB,IAAI,CAAC;YAAC,IAAA,4BAAc,EAAC,QAAQ,CAAC,CAAC;YAAC,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC;QAAC,CAAC;QACxD,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,8EAA8E;IAE9E,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE;QAC7B,WAAW,EAAE,yFAAyF;QACtG,WAAW,EAAE,EAAE,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,EAAE;KAC5D,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;QAClB,MAAM,OAAO,GAAG,QAAQ,KAAK,QAAQ;YACnC,CAAC,CAAC,IAAA,2BAAe,EAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;YAC/C,CAAC,CAAC,IAAA,mCAAmB,EAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACtD,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE;QAC/B,WAAW,EAAE,wHAAwH;QACrI,WAAW,EAAE;YACX,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;YAChB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;YACpB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC5B,WAAW,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACpC;KACF,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAA,sBAAQ,EAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;YACrE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1G,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE;QACnC,WAAW,EAAE;;;;;0HAKyG;QACtH,WAAW,EAAE,EAAE,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;KAC7C,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;QAClB,IAAI,CAAC;YAAC,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAC,CAAC;QAC1C,OAAO,CAAC,EAAE,CAAC;YAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,8EAA8E;IAE9E,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,yBAAgB,CAAC,QAAQ,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACnI,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,IAAI,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;SACzF,CAAC,CAAC,CAAC;IACN,CAAC;IAED,8EAA8E;IAE9E,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,KAAK,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;AACxF,CAAC"}
|
package/dist/resources/guide.md
CHANGED
|
@@ -161,8 +161,8 @@ ok: true
|
|
|
161
161
|
```
|
|
162
162
|
|
|
163
163
|
Errors:
|
|
164
|
-
- `error: claim on seq <n> expired` — seq no longer exists;
|
|
165
|
-
- `error: item seq <n> not claimed` —
|
|
164
|
+
- `error: claim on seq <n> expired` — seq no longer exists; discard your work
|
|
165
|
+
- `error: item seq <n> not claimed` — items should be claimed before releasing - likely bug
|
|
166
166
|
- `error: payload is not valid YAML: <detail>` — `payloadFormat` is `yaml` (default) and payload fails YAML parse
|
|
167
167
|
- `error: payload is not valid JSON: <detail>` — `payloadFormat` is `json` and payload fails JSON parse
|
|
168
168
|
|
package/package.json
CHANGED
package/src/mcp.ts
CHANGED
|
@@ -17,7 +17,10 @@ const VERSION = JSON.parse(
|
|
|
17
17
|
readFileSync(join(__dirname, '../package.json'), 'utf8')
|
|
18
18
|
).version as string;
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
const RESOURCES = ['guide', 'chrome', 'pipeline_design'] as const;
|
|
21
|
+
type Resource = typeof RESOURCES[number];
|
|
22
|
+
|
|
23
|
+
function loadResource(name: Resource): string {
|
|
21
24
|
return readFileSync(join(__dirname, 'resources', `${name}.md`), 'utf8');
|
|
22
25
|
}
|
|
23
26
|
|
|
@@ -203,19 +206,26 @@ export async function startMcp(fixedPort?: number): Promise<void> {
|
|
|
203
206
|
} catch (e) { return err(e); }
|
|
204
207
|
});
|
|
205
208
|
|
|
206
|
-
|
|
209
|
+
server.registerTool('resource_read', {
|
|
210
|
+
description: `Read a QQ documentation resource by name. Use this tool if your environment cannot read MCP resources directly.
|
|
207
211
|
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
212
|
+
Available resources:
|
|
213
|
+
- guide — Complete reference: mental model, all MCP tools with parameters/returns/errors, SDK usage examples. Read this before using any QQ tool.
|
|
214
|
+
- pipeline_design — Step-by-step pipeline design guide: how to design stages, write PIPELINES.md, and run the pre-implementation checklist.
|
|
215
|
+
- chrome — Chrome browser automation patterns for QQ pipelines: tab reuse, script injection, progress monitoring.`,
|
|
216
|
+
inputSchema: { resource: z.enum(RESOURCES) },
|
|
217
|
+
}, ({ resource }) => {
|
|
218
|
+
try { return ok(loadResource(resource)); }
|
|
219
|
+
catch (e) { return err(e); }
|
|
220
|
+
});
|
|
211
221
|
|
|
212
|
-
|
|
213
|
-
contents: [{ uri: 'qq://chrome', mimeType: 'text/markdown', text: loadResource('chrome') }],
|
|
214
|
-
}));
|
|
222
|
+
// ── Resources ──────────────────────────────────────────────────────────────
|
|
215
223
|
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
224
|
+
for (const name of RESOURCES) {
|
|
225
|
+
server.registerResource(name, new ResourceTemplate(`qq://${name}`, { list: undefined }), { mimeType: 'text/markdown' }, async () => ({
|
|
226
|
+
contents: [{ uri: `qq://${name}`, mimeType: 'text/markdown', text: loadResource(name) }],
|
|
227
|
+
}));
|
|
228
|
+
}
|
|
219
229
|
|
|
220
230
|
// ── Connect ────────────────────────────────────────────────────────────────
|
|
221
231
|
|