@jinshuju/mcp 0.2.0 → 0.4.0

package/dist/result.d.ts

@@ -5,4 +5,6 @@
 import type { CallToolResult } from '@modelcontextprotocol/server';
 import type { ApiResponse } from './api.js';
 import type { ToolSpec } from './types.js';
+/** The 403 hint; it names the scope itself, so analytics.ts leaves it out when looking for a scope failure in the API's own words. */
+export declare const FORBIDDEN_HINT = "No permission, a quota is used up, or the OAuth scope is insufficient.";
 export declare function toToolResult(tool: ToolSpec, res: ApiResponse, maxResultChars: number): CallToolResult;

package/dist/result.js

@@ -21,6 +21,8 @@ function errorLines(res) {
         lines.push(res.text);
     return lines;
 }
+/** The 403 hint; it names the scope itself, so analytics.ts leaves it out when looking for a scope failure in the API's own words. */
+export const FORBIDDEN_HINT = 'No permission, a quota is used up, or the OAuth scope is insufficient.';
 function hint(status, res) {
     switch (status) {
         case 400:
@@ -30,7 +32,7 @@ function hint(status, res) {
         case 402:
             return 'The current plan does not include API v1.';
         case 403:
-            return 'No permission, a quota is used up, or the OAuth scope is insufficient.';
+            return FORBIDDEN_HINT;
         case 404:
             return 'The resource does not exist or this credential cannot access it (check the token / serial number).';
         case 415:

package/dist/server.js

@@ -12,7 +12,7 @@ export const INSTRUCTIONS = [
     'MCP server for Jinshuju (金数据) forms, tables and entries. Each tool maps to the open API v1 and is generated from its openapi.yaml.',
     "Usual path: list_forms finds the form token → get_form shows the fields' api_code → list_entries / count_entries / aggregate_entries read entries;",
     'create_entry / patch_entries write them, keyed by api_code.',
-    'To create a form: get_schema("FieldInput") lists the field types, get_schema("<Type>Input") shows a type\'s properties, then call create_form.',
+    'To create a form: get_schema("FieldInput") maps each field type to its schema in x-variants (TextField → TextFieldInput, SingleSelect → SingleSelectInput), get_schema on that name shows the type\'s properties, then call create_form.',
     'Wherever an input says `Shape: schema "X"`, look X up with get_schema; do not guess.',
     "An error gives the HTTP status and the server's error_description / errors; fix the call as they say and retry. On 429, wait as Retry-After says.",
     'A personal token sees only the forms its user created or that are shared with them; an account token sees every form in the account.'

package/dist/tools.js

@@ -47,6 +47,40 @@ export function registerGeneratedTools(server, runtime) {
 export function schemaNames() {
     return Object.keys(SCHEMAS);
 }
+/** Lower-case words of a schema or tool name, without Input; edit reads as update, since tools say edit where schemas say Update. */
+function nameWords(name) {
+    const words = name.match(/[A-Z]+(?![a-z])|[A-Z]?[a-z]+|\d+/g) ?? [];
+    return new Set(words
+        .map((word) => word.toLowerCase())
+        .filter((word) => word !== 'input')
+        .map((word) => (word === 'edit' ? 'update' : word)));
+}
+/** Schema names containing the name come first, then those sharing the most words with it. */
+function similarSchemaNames(name) {
+    const lower = name.toLowerCase();
+    const words = nameWords(name);
+    const score = (candidate) => {
+        if (candidate.toLowerCase().includes(lower))
+            return 2;
+        const other = nameWords(candidate);
+        const shared = [...words].filter((word) => other.has(word)).length;
+        return shared / new Set([...words, ...other]).size;
+    };
+    return schemaNames()
+        .map((candidate) => ({ candidate, score: score(candidate) }))
+        .filter((scored) => scored.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, 5)
+        .map((scored) => scored.candidate);
+}
+/** get_schema's answer to an unknown name: a guessed tool input (EditFormInput) is pointed back at the tool, anything else gets similar names. */
+function unknownSchemaMessage(name) {
+    const tool = TOOLS.find((t) => `${t.name.replaceAll('_', '')}input` === name.toLowerCase());
+    if (tool)
+        return `No schema named ${name}. ${tool.name} takes the arguments listed in its own inputSchema; there is no schema to look up for them.`;
+    const candidates = similarSchemaNames(name);
+    return `No schema named ${name}.${candidates.length ? ` Similar names: ${candidates.join(', ')}` : ''}`;
+}
 export function registerSchemaTools(server, pointerSchemas) {
     server.registerTool('get_schema', {
         title: 'Show a schema',
@@ -56,7 +90,10 @@ export function registerSchemaTools(server, pointerSchemas) {
         inputSchema: fromJsonSchema({
             type: 'object',
             properties: {
-                name: { type: 'string', description: 'Schema name, e.g. FieldInput, TextFieldInput, FormSettingWriteInput' }
+                name: {
+                    type: 'string',
+                    description: 'Schema name, e.g. FieldInput, TextFieldInput, SingleSelectInput, FormSettingWriteInput'
+                }
             },
             required: ['name'],
             additionalProperties: false
@@ -64,20 +101,8 @@ export function registerSchemaTools(server, pointerSchemas) {
         annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     }, async ({ name }) => {
         const schema = SCHEMAS[name];
-        if (!schema) {
-            const candidates = schemaNames()
-                .filter((n) => n.toLowerCase().includes(name.toLowerCase()))
-                .slice(0, 10);
-            return {
-                isError: true,
-                content: [
-                    {
-                        type: 'text',
-                        text: `No schema named ${name}.${candidates.length ? ` Similar names: ${candidates.join(', ')}` : ''}`
-                    }
-                ]
-            };
-        }
+        if (!schema)
+            return { isError: true, content: [{ type: 'text', text: unknownSchemaMessage(name) }] };
         return { content: [{ type: 'text', text: JSON.stringify(schema) }] };
     });
 }

package/dist/types.d.ts

@@ -9,6 +9,8 @@ export interface ParamSpec {
     required: boolean;
     /** A query array is serialized as name[]=a&name[]=b (the server reads it as an array) */
     array?: boolean;
+    /** Declared with `content: application/json`: sent as one query value holding JSON text (a string is passed through as is) */
+    json?: boolean;
 }
 export interface BodySpec {
     contentType: 'application/json' | 'multipart/form-data';

package/dist/version.d.ts

@@ -1,3 +1,3 @@
-export declare const VERSION = "0.2.0";
+export declare const VERSION = "0.4.0";
 export declare const SERVER_NAME = "jinshuju";
 export declare const SERVER_TITLE = "Jinshuju MCP Server";

package/dist/version.js

@@ -1,5 +1,5 @@
-// release-please keeps this in sync through extra-files; the runtime does not read package.json because Workers has no file system.
-export const VERSION = '0.2.0'; // x-release-please-version
+// scripts/release.mjs keeps this in step with package.json; the runtime does not read package.json because Workers has no file system.
+export const VERSION = '0.4.0'; // x-release-version
 export const SERVER_NAME = 'jinshuju';
 export const SERVER_TITLE = 'Jinshuju MCP Server';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jinshuju/mcp",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "MCP server for the Jinshuju (金数据) Open API v1, generated from openapi.yaml",
   "homepage": "https://github.com/jinshuju/mcp#readme",
   "bugs": {
@@ -66,7 +66,7 @@
     "oxfmt": "^0.72.0",
     "oxlint": "^1.87.0",
     "tsx": "^4.23.0",
-    "typescript": "^5.9.3",
+    "typescript": "^7.0.2",
     "wrangler": "^4.149.0",
     "yaml": "^2.9.1"
   },