@jinshuju/mcp 0.4.0 → 0.5.0

package/README.md

@@ -1,7 +1,7 @@
 # @jinshuju/mcp
 
 The MCP server for Jinshuju ([jinshuju.net](https://jinshuju.net)): lets Claude, Cursor, Claude Code and other MCP-capable AI tools read and write forms, tables and entries.
-The tools are generated from the [open API v1 openapi.yaml](https://jinshuju.net/api/v1/openapi.yaml) and stay in step with the API; the tool set matches the tools documented for the [Jinshuju MCP Server](https://open.jinshuju.net/mcp) one to one.
+The tools are generated from the [open API v1 openapi.yaml](https://jinshuju.net/api/v1/openapi.yaml) and stay in step with the API.
 
 Two ways to use it:
 
@@ -49,7 +49,7 @@ To check it works, ask the assistant to "list my Jinshuju forms".
 
 ## Tools
 
-The 60 tools documented for the [Jinshuju MCP Server](https://open.jinshuju.net/mcp), with the same names, plus delete_form. Each tool maps to one operation in openapi.yaml; a few combine two operations:
+Each tool maps to one operation in openapi.yaml; a few combine two operations:
 
 | Category            | Tools                                                                                                                                                                                                                               |
 | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -62,11 +62,16 @@ The 60 tools documented for the [Jinshuju MCP Server](https://open.jinshuju.net/
 | Tables              | list_tables, get_table, create_table, edit_table, move_table                                                                                                                                                                        |
 | Public queries      | list_opensearch_queries, get_opensearch_query, create_opensearch_query, edit_opensearch_query, get_opensearch_field_suggestions                                                                                                     |
 | Folders / account   | list_folders, create_folder, get_current_user, get_current_billing_account, list_account_users                                                                                                                                      |
-| Uploads             | upload_entry_attachment, upload_form_image, upload_import_file                                                                                                                                                                      |
+| Uploads             | prepare_entry_attachment_upload, prepare_form_image_upload, prepare_import_file_upload, upload_entry_attachment, upload_form_image, upload_import_file                                                                              |
 | Schemas             | get_schema (reads an openapi schema by name, e.g. FieldInput, TextFieldInput)                                                                                                                                                       |
 
 The full tool → operation mapping is in `mcp.overlay.yaml` and `src/generated/meta.json`.
 
+**Uploads.** A file on disk goes through `prepare_*_upload`, which returns a one-time `upload_url` (valid 30 minutes);
+the client posts the file to it itself (`curl -F file=@<path> <upload_url>`), so its bytes never pass through the model, then uses the returned `attachment_id`.
+That needs a client with a shell that can reach jinshuju.net, such as Claude Code, Cursor or Codex.
+`upload_*` carry the file as Base64 inside the tool call, which only suits small content the model has in hand.
+
 **Size.** The full tools/list is about 39k tokens (o200k estimate; about 36k without outputSchema).
 It stays that size by not inlining large schemas: field definitions (52 types), form settings, themes and the like become a one-line pointer; unions that branch on type, such as table columns, keep only their common properties.
 The model reads them on demand with `get_schema("FieldInput")` / `get_schema("TextFieldInput")`.

package/dist/generated/meta.json

@@ -2,11 +2,11 @@
     "generatedFrom": {
         "title": "Jinshuju API v1",
         "version": "1.0",
-        "sha256": "ecaf2b639eaf7555"
+        "sha256": "aecc3bef9088dcc7"
     },
     "baseUrl": "https://jinshuju.net/api/v1",
-    "toolCount": 61,
-    "operationCount": 129,
+    "toolCount": 64,
+    "operationCount": 176,
     "tools": {
         "list_forms": "listForms",
         "get_form": "getForm",
@@ -60,6 +60,9 @@
         "get_current_user": "getCurrentUser",
         "get_current_billing_account": "getBillingAccount",
         "list_account_users": "listBillingAccountUsers",
+        "prepare_entry_attachment_upload": "prepareEntryAttachmentUpload",
+        "prepare_form_image_upload": "prepareFormImageUpload",
+        "prepare_import_file_upload": "prepareImportFileUpload",
         "upload_entry_attachment": "uploadEntryAttachment",
         "upload_form_image": "uploadFormImage",
         "upload_import_file": "uploadImportFile",
@@ -71,24 +74,26 @@
         "count_entries": "countEntries+countEntriesAcrossForms"
     },
     "pointerSchemas": [
-        "BillingAccount",
-        "EntryData",
-        "EvaluationSetting",
-        "EvaluationSettingInput",
-        "FieldDefinition",
         "FieldInput",
         "FieldUpdateInput",
-        "FormSetting",
-        "FormSettingInput",
+        "FieldDefinition",
         "FormSettingWriteInput",
+        "FormSettingInput",
+        "FormSetting",
+        "ThemeInput",
         "FormTheme",
-        "FormView",
+        "EvaluationSettingInput",
+        "EvaluationSetting",
         "FormViewInput",
-        "GoodsItemInput",
-        "OpensearchQuery",
+        "FormView",
         "OpensearchQueryInput",
-        "ThemeInput",
-        "TradeMerchant"
+        "OpensearchQuery",
+        "GoodsItemInput",
+        "EntryData",
+        "TradeMerchant",
+        "BillingAccount",
+        "ExamFieldInput",
+        "EvaluationFieldInput"
     ],
     "omitSchemas": [
         "FormCreateConstraints"
@@ -97,7 +102,7 @@
         "Forms": "Forms: list, structure, create and edit, plus field display rules, cooperators, copy, move and other related operations.",
         "Form Settings": "Form settings: submission settings, access policy, Webhook, theme, closing rules, exam / evaluation scene settings.",
         "Plugins": "Plugin center plugins (check-in for now). A plugin campaign is bound to one form, and only its creator can see and change it. The account must have enabled the plugin in the plugin center, or the request returns 402.",
-        "Entries": "Form entries: list, query, create, update, delete and batch operations.",
+        "Entries": "Form entries: list, query, create, update, delete and batch operations, and sending SMS / email to entries.",
         "Tables": "Tables (kind=table): structure and entries; field types are limited to the column types tables support.",
         "Views": "Form / table views (view filters, sort, column configuration) and reading entries through a view.",
         "Comments": "Entry comments.",
@@ -107,9 +112,10 @@
         "Predefined Choices Sets": "Predefined choice sets.",
         "Templates": "Using templates.",
         "Contacts": "Contacts.",
-        "Account": "Current user and account: members, e-invoices, payment history, SMS signature review status.",
+        "Account": "Current user and account: members, e-invoices, payment history, SMS signatures and templates, SMTP accounts.",
         "Trade": "小金商户: merchant and onboarding progress, payment orders, transaction statistics, refunds and payouts.",
-        "Uploads": "Uploading attachments, form images and import files.",
-        "Utilities": "Utility endpoints."
+        "Uploads": "Uploading attachments, form images, license images and import files.",
+        "Utilities": "Utility endpoints.",
+        "Routines": "Routines (`自动任务`): instructions Jiri carries out as you, on a schedule or when data changes, and their runs. The rules and messages are those of the routines page; times are in Beijing time (+08:00). OAuth tokens need the `routines` scope. As routines run unattended and spend AI points, self-registered clients cannot get it; only a registered application with `routines` among its scopes (such as the Jinshuju CLI) can ask for it."
     }
 }