store-mcp-node 0.1.0 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "store-mcp-node",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP (Model Context Protocol) adapter that auto-generates tool surfaces for nodejs-store schemas (schema-driven CRUD + sandboxed GQL query + optional ask), stdio transport",
   "main": "src/index.js",
   "files": [

package/src/index.js

@@ -54,6 +54,9 @@ function errorOf(e) {
   if (e && e.name === 'SkinError') return { code: e.code, message: e.message };
   if (e && e.name === 'AskExhausted') return { code: 'askExhausted', message: String(e.message) };
   if (e && e.name === 'PermissionError') return { code: 'permissionDenied', message: String(e.message) };
+  if (e && (e.name === 'NoContextError' || e.code === 'no_context')) {
+    return { code: 'noContext', message: String(e.message) };
+  }
   if (e && e.name === 'ProfileViolation') return { code: 'profileBlocked', message: String(e.message) };
   return { code: 'planError', message: String((e && e.message) || e) };
 }
@@ -87,6 +90,12 @@ const ASK_TOOL = {
   inputSchema: obj({ question: { type: 'string', description: '自然语言问题' } }, ['question']),
 };
 
+const DESCRIBE_TOOL = {
+  name: 'describe_schemas',
+  description: '列出可用数据模型及其字段/关系/计算列（权限过滤后的紧凑 JSON）。翻译 GQL 前先调用本工具获取 schema；无权限上下文时仅返回模型名与字段名',
+  inputSchema: obj({}, []),
+};
+
 /**
  * 收集工具面（归档过滤 + x-mcp 注记 + ask 启用守卫）。
  * @returns {{tools: object[], handlers: Map<string, Function>}}
@@ -116,6 +125,10 @@ function buildSurface(store, opts = {}) {
   tools.push(QUERY_TOOL);
   handlers.set('query', queryHandler(store, opts));
 
+  // spec/01：describe_schemas —— AI 自主翻译 GQL 前的 schema 出口（零入参；ctx 走 opts，不进 inputSchema）
+  tools.push(DESCRIBE_TOOL);
+  handlers.set('describe_schemas', describeHandler(store, opts));
+
   // spec/01：ask 仅 opts.llm 提供时注册；配 llm 缺 ctx 装配期抛错（fail-secure）
   if (opts.llm !== undefined && opts.llm !== null) {
     if (opts.ctx === undefined || opts.ctx === null) {
@@ -171,6 +184,15 @@ function queryHandler(store, opts) {
   };
 }
 
+function describeHandler(store, opts) {
+  return async () => {
+    if (typeof store.describeForAi !== 'function') {
+      throw new SkinError('planError', 'store 未提供 describeForAi（需提供该门面的 nodejs-store 宿主）');
+    }
+    return store.describeForAi(opts.ctx === undefined ? null : opts.ctx);
+  };
+}
+
 function askHandler(opts) {
   return async (args) => {
     if (typeof args.question !== 'string' || !args.question.trim()) {