@getnote/mcp 1.5.2 → 1.6.0

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 CHANGED
@@ -7,6 +7,8 @@ MCP (Model Context Protocol) server for [得到大脑(Get笔记)](https://bi
7
7
  得到大脑(Get笔记)是一款个人笔记管理工具。通过此 MCP Server,AI 模型可以帮助用户管理笔记。
8
8
 
9
9
  > 🔑 **获取 API Key**:https://www.biji.com/openapi
10
+ >
11
+ > 💡 **开通会员**:[前往得到大脑会员购买页](https://www.biji.com/checkout?product_alias=9Ab36BB3ZD&spm=openapi_mcp)
10
12
 
11
13
  ## 使用场景
12
14
 
@@ -81,6 +83,8 @@ GETNOTE_API_KEY=your_api_key GETNOTE_CLIENT_ID=your_client_id node dist/index.js
81
83
  # 持久化(添加到 ~/.zshrc 或 ~/.bashrc)
82
84
  export GETNOTE_API_KEY=gk_live_xxx
83
85
  export GETNOTE_CLIENT_ID=cli_xxx
86
+ # 可选:仅在明确联调测试环境时覆盖
87
+ export GETNOTE_API_URL=http://entree.dev.didatrip.com
84
88
  ```
85
89
 
86
90
  ### CLI flag
@@ -191,6 +195,14 @@ Input: {
191
195
 
192
196
  Get your API Key and Client ID at [得到大脑(Get笔记)开放平台](https://www.biji.com/openapi).
193
197
 
198
+ ### 新版契约兼容
199
+
200
+ - 所有雪花 ID 优先传十进制字符串。为兼容历史调用,工具仍接受 JavaScript 安全整数;超过 `Number.MAX_SAFE_INTEGER` 的数字会被拒绝,避免静默精度损失。
201
+ - `save_note` 支持 `topic_id`、`parent_id`、`client_request_id`。重试同一创建请求时复用同一个 `client_request_id`。
202
+ - `list_topics` 返回用户拥有的 `DEFAULT`、`BOOKSPACE`、`CUSTOMER` 三类知识库,可把目标 `topic_id` 直接传给 `save_note`。
203
+ - 即使 HTTP 为 200,`success:false` 仍按失败处理;错误结果保留 `code/reason/retryable/field/constraint/expected_type/request_id`。
204
+ - `GETNOTE_API_URL` 可传站点根地址、`/open` 或完整 `/open/api/v1`;未设置时仍使用生产地址。
205
+
194
206
  ## 🚀 进阶用法:用笔记内链实践柳比歇夫时间日志法
195
207
 
196
208
  柳比歇夫时间日志法的核心是**每天记录自己把时间花在了哪里**,事后统计、复盘、改进。
package/dist/client.d.ts CHANGED
@@ -1,17 +1,32 @@
1
+ /**
2
+ * Preserves long-integer ID fields as JSON strings before JSON.parse, so JS
3
+ * doesn't silently round-trip them through `number` (which loses precision
4
+ * beyond 2^53 ≈ 9e15). Get笔记 note IDs are snowflake-like (≈ 1.9e18) and
5
+ * exceed this limit, so without this hook `note_id` / `next_cursor` come
6
+ * back corrupted and cursor pagination silently loops on the same page.
7
+ *
8
+ * Matches only when the captured field value has 16+ digits, so short IDs
9
+ * remain numbers.
10
+ */
11
+ export declare function parseJsonPreservingLargeIntegerStrings(data: unknown): any;
1
12
  export declare class GetNoteAPIError extends Error {
2
13
  readonly code: number;
3
14
  readonly reason: string;
4
15
  readonly requestId?: string | undefined;
5
- constructor(code: number, reason: string, message: string, requestId?: string | undefined);
16
+ readonly retryable: boolean;
17
+ readonly field?: string | undefined;
18
+ readonly constraint?: string | undefined;
19
+ readonly expectedType?: string | undefined;
20
+ constructor(code: number, reason: string, message: string, requestId?: string | undefined, retryable?: boolean, field?: string | undefined, constraint?: string | undefined, expectedType?: string | undefined);
6
21
  }
7
22
  export declare class GetNoteClient {
8
23
  private http;
9
- constructor(apiKey: string, clientId: string);
24
+ constructor(apiKey: string, clientId: string, baseURL?: string);
10
25
  private request;
11
26
  listNotes(params: {
12
27
  cursor?: string;
13
28
  }): Promise<ListNotesResp>;
14
- getNote(id: number | string, image_quality?: string): Promise<GetNoteResp>;
29
+ getNote(id: string | number, image_quality?: string): Promise<GetNoteResp>;
15
30
  saveNote(body: SaveNoteReq): Promise<SaveNoteResp>;
16
31
  deleteNote(note_id: number | string): Promise<DeleteNoteResp>;
17
32
  updateNote(body: UpdateNoteReq): Promise<UpdateNoteResp>;
@@ -175,12 +190,13 @@ export interface GetNoteResp {
175
190
  note: NoteDetail;
176
191
  }
177
192
  export interface SaveNoteReq {
178
- id?: number | string;
179
193
  title?: string;
180
194
  content?: string;
181
195
  note_type?: "plain_text" | "link" | "img_text";
182
196
  tags?: string[];
183
- parent_id?: number | string;
197
+ topic_id?: string;
198
+ parent_id?: string | number;
199
+ client_request_id?: string;
184
200
  link_url?: string;
185
201
  image_urls?: string[];
186
202
  }
@@ -191,11 +207,15 @@ export interface NoteTaskItem {
191
207
  url: string;
192
208
  }
193
209
  export interface SaveNoteResp {
194
- id: string;
195
- title: string;
196
- created_at: string;
197
- updated_at: string;
210
+ /** Legacy numeric field; transformed to a string when it exceeds JS safe range. */
211
+ id?: string | number;
212
+ /** Canonical lossless note ID. */
213
+ note_id?: string;
214
+ title?: string;
215
+ created_at?: string;
216
+ updated_at?: string;
198
217
  message?: string;
218
+ result?: "created" | "accepted";
199
219
  /** 链接笔记创建时返回的任务列表 */
200
220
  tasks?: NoteTaskItem[];
201
221
  /** 成功创建的笔记数量 */
@@ -204,6 +224,8 @@ export interface SaveNoteResp {
204
224
  duplicate_count?: number;
205
225
  /** 无效的链接数量 */
206
226
  invalid_count?: number;
227
+ duplicate_urls?: string[];
228
+ invalid_urls?: string[];
207
229
  }
208
230
  export interface NoteTaskProgress {
209
231
  /** 任务 ID */
@@ -235,7 +257,6 @@ export interface DeleteNoteTagResp {
235
257
  export interface GetUploadConfigResp {
236
258
  support_extensions: string[];
237
259
  max_size_bytes: number;
238
- max_count: number;
239
260
  }
240
261
  export interface ImageUploadToken {
241
262
  accessid: string;
@@ -283,7 +304,7 @@ export interface TopicNoteItem {
283
304
  content: string;
284
305
  note_type: string;
285
306
  tags: string[];
286
- is_ai?: boolean;
307
+ is_ai_generated?: boolean;
287
308
  created_at: string;
288
309
  edit_time: string;
289
310
  }
@@ -317,7 +338,8 @@ export interface GetQuotaResp {
317
338
  write_note: QuotaBucket;
318
339
  }
319
340
  export interface BloggerItem {
320
- follow_id: number;
341
+ follow_id: string | number;
342
+ follow_id_str?: string;
321
343
  account_name: string;
322
344
  account_avatar: string;
323
345
  notes_count: number;
@@ -353,8 +375,9 @@ export interface BloggerContentDetail extends BloggerContentItem {
353
375
  post_media_text: string;
354
376
  }
355
377
  export interface LiveItem {
356
- live_id: string | number;
357
- follow_id: number;
378
+ live_id: string;
379
+ follow_id: string | number;
380
+ follow_id_str?: string;
358
381
  name: string;
359
382
  cover: string;
360
383
  sub_title: string;
@@ -382,7 +405,8 @@ export interface LiveDetail {
382
405
  post_publish_time: string;
383
406
  }
384
407
  export interface FollowTopicLiveResp {
385
- follow_id: number;
408
+ follow_id: string | number;
409
+ follow_id_str?: string;
386
410
  url: string;
387
411
  platform: string;
388
412
  type: string;
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAuBA,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,MAAM;aAEd,SAAS,CAAC,EAAE,MAAM;gBAHlB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM,EACC,SAAS,CAAC,EAAE,MAAM,YAAA;CAKrC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAgB;gBAEhB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;YAoB9B,OAAO;IAyDf,SAAS,CAAC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAMrC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;IAInD,QAAQ,CAAC,IAAI,EAAE,WAAW;IAI1B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAMnC,UAAU,CAAC,IAAI,EAAE,aAAa;IAI9B,mBAAmB,CAAC,OAAO,EAAE,MAAM;IAWnC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;IASpD,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM;IAWtD,eAAe;IAOf,cAAc,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAQnE;;;;;;OAMG;IACG,gBAAgB,CACpB,KAAK,EAAE,gBAAgB,EACvB,SAAS,EAAE,MAAM,GAAG,UAAU,GAC7B,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAkChC;;;;;OAKG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,GAAG,UAAU,EAC9B,QAAQ,GAAE,MAAc,GACvB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAa9C,UAAU,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAOpD,WAAW,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IASxE,cAAc,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAQ1D,oBAAoB,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IASnE,mBAAmB,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IAWlE,iBAAiB,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAQ7D,wBAAwB,CAAC,MAAM,EAAE;QACrC,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;IAQK,uBAAuB,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAUrE,cAAc,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAQ1D,aAAa,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE;IAQpE,eAAe,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAS1D,SAAS,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAAE;IASpE,mBAAmB,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAU7C,QAAQ;IAMR,MAAM,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAI9C,eAAe,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAGhF;AAID,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAClC;AAED,MAAM,WAAW,QAAQ;IACvB;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,EAAE,CAAC;IACJ,KAAK,CAAC,EAAE;QACN,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,8BAA8B;QAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,mBAAmB;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC;IAC/C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,gBAAgB;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;IACxD,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAGD,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,WAAW,CAAC;CACzB;AAID,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,eAAe,EAAE,MAAM,CAAC;CACzB;AAID,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAID,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
package/dist/client.js CHANGED
@@ -37,8 +37,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
37
37
  };
38
38
  Object.defineProperty(exports, "__esModule", { value: true });
39
39
  exports.GetNoteClient = exports.GetNoteAPIError = void 0;
40
+ exports.parseJsonPreservingLargeIntegerStrings = parseJsonPreservingLargeIntegerStrings;
40
41
  const axios_1 = __importDefault(require("axios"));
41
- const BASE_URL = "https://openapi.biji.com/open/api/v1";
42
+ const DEFAULT_BASE_URL = "https://openapi.biji.com/open/api/v1";
43
+ function normalizeBaseURL(value) {
44
+ const base = (value || DEFAULT_BASE_URL).replace(/\/+$/, "");
45
+ if (base.endsWith("/open/api/v1"))
46
+ return base;
47
+ if (base.endsWith("/open"))
48
+ return `${base}/api/v1`;
49
+ return `${base}/open/api/v1`;
50
+ }
42
51
  /**
43
52
  * Preserves long-integer ID fields as JSON strings before JSON.parse, so JS
44
53
  * doesn't silently round-trip them through `number` (which loses precision
@@ -52,27 +61,35 @@ const BASE_URL = "https://openapi.biji.com/open/api/v1";
52
61
  function parseJsonPreservingLargeIntegerStrings(data) {
53
62
  if (typeof data !== "string" || data.trim() === "")
54
63
  return data;
55
- const safe = data.replace(/"(note_id|next_cursor|cursor|id|parent_id|topic_id|since_id|share_id)"\s*:\s*(\d{16,})/g, '"$1":"$2"');
64
+ const safe = data.replace(/"(note_id|next_cursor|cursor|id|parent_id|topic_id|since_id|share_id|follow_id|live_id)"\s*:\s*(\d{16,})/g, '"$1":"$2"').replace(/([:[,]\s*)(-?\d{16,})(?=\s*[,}\]])/g, '$1"$2"');
56
65
  return JSON.parse(safe);
57
66
  }
58
67
  class GetNoteAPIError extends Error {
59
68
  code;
60
69
  reason;
61
70
  requestId;
62
- constructor(code, reason, message, requestId) {
71
+ retryable;
72
+ field;
73
+ constraint;
74
+ expectedType;
75
+ constructor(code, reason, message, requestId, retryable = false, field, constraint, expectedType) {
63
76
  super(message);
64
77
  this.code = code;
65
78
  this.reason = reason;
66
79
  this.requestId = requestId;
80
+ this.retryable = retryable;
81
+ this.field = field;
82
+ this.constraint = constraint;
83
+ this.expectedType = expectedType;
67
84
  this.name = "GetNoteAPIError";
68
85
  }
69
86
  }
70
87
  exports.GetNoteAPIError = GetNoteAPIError;
71
88
  class GetNoteClient {
72
89
  http;
73
- constructor(apiKey, clientId) {
90
+ constructor(apiKey, clientId, baseURL) {
74
91
  this.http = axios_1.default.create({
75
- baseURL: BASE_URL,
92
+ baseURL: normalizeBaseURL(baseURL || process.env.GETNOTE_API_URL),
76
93
  headers: {
77
94
  Authorization: `Bearer ${apiKey}`,
78
95
  "X-Client-ID": clientId,
@@ -96,7 +113,7 @@ class GetNoteClient {
96
113
  const body = res.data;
97
114
  if (!body.success) {
98
115
  const err = body.error;
99
- throw new GetNoteAPIError(err?.code ?? -1, err?.reason ?? "unknown", err?.message ?? "API request failed", body.request_id);
116
+ throw new GetNoteAPIError(err?.code ?? -1, err?.reason ?? "unknown", err?.message ?? "API request failed", body.request_id, err?.retryable ?? false, err?.field, err?.constraint, err?.expected_type);
100
117
  }
101
118
  return body.data;
102
119
  }
@@ -106,7 +123,7 @@ class GetNoteClient {
106
123
  if (axios_1.default.isAxiosError(err) && err.response) {
107
124
  const body = err.response.data;
108
125
  if (body?.error) {
109
- throw new GetNoteAPIError(body.error.code, body.error.reason, body.error.message, body.request_id);
126
+ throw new GetNoteAPIError(body.error.code, body.error.reason, body.error.message, body.request_id, body.error.retryable ?? false, body.error.field, body.error.constraint, body.error.expected_type);
110
127
  }
111
128
  throw new Error(`HTTP ${err.response.status}: ${err.message}`);
112
129
  }
@@ -161,26 +178,26 @@ class GetNoteClient {
161
178
  // 使用 FormData 构建 multipart 请求
162
179
  const FormData = (await Promise.resolve().then(() => __importStar(require("form-data")))).default;
163
180
  const form = new FormData();
181
+ form.append("key", token.object_key);
164
182
  form.append("OSSAccessKeyId", token.accessid);
165
183
  form.append("policy", token.policy);
166
- form.append("Signature", token.signature);
167
- form.append("key", token.object_key);
184
+ form.append("signature", token.signature);
168
185
  form.append("callback", token.callback);
169
- form.append("success_action_status", "200");
186
+ form.append("Content-Type", token.oss_content_type);
170
187
  form.append("file", imageData, {
171
188
  filename: "image",
172
189
  contentType: token.oss_content_type,
173
190
  });
174
- const response = await fetch(token.host, {
175
- method: "POST",
176
- body: form,
191
+ const response = await axios_1.default.post(token.host, form, {
177
192
  headers: form.getHeaders(),
193
+ maxBodyLength: Infinity,
194
+ validateStatus: () => true,
178
195
  });
179
- if (!response.ok) {
196
+ if (response.status < 200 || response.status >= 300) {
180
197
  throw new Error(`OSS upload failed: ${response.status}`);
181
198
  }
182
199
  // 解析回调响应: {"h":{"c":0},"c":{"image":{"id":"xxx"}}}
183
- const result = await response.json();
200
+ const result = response.data;
184
201
  if (result.h?.c !== 0) {
185
202
  throw new Error("OSS callback failed");
186
203
  }
package/dist/index.js CHANGED
@@ -45,6 +45,7 @@ const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
45
45
  const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
46
46
  const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
47
47
  const client_js_1 = require("./client.js");
48
+ const membership_js_1 = require("./membership.js");
48
49
  const node_fs_1 = require("node:fs");
49
50
  const node_path_1 = require("node:path");
50
51
  const pkg = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, "..", "package.json"), "utf-8"));
@@ -125,18 +126,27 @@ function getClientId() {
125
126
  console.error("Error: Client ID required. Set GETNOTE_CLIENT_ID env var or pass --client-id <id>");
126
127
  process.exit(1);
127
128
  }
129
+ function snowflakeID(value, field) {
130
+ if (typeof value === "string" && /^\d+$/.test(value)) {
131
+ return value;
132
+ }
133
+ if (typeof value === "number" && Number.isSafeInteger(value) && value >= 0) {
134
+ return value;
135
+ }
136
+ throw new Error(`${field} must be a decimal string; only legacy integers within JavaScript's safe range are accepted`);
137
+ }
128
138
  // ─── Tool Definitions ────────────────────────────────────────────────────────
129
139
  const TOOLS = [
130
140
  // ── Notes ──
131
141
  {
132
142
  name: "list_notes",
133
- description: "获取笔记列表(每次固定返回 20 条)。首次请求 since_id 传 0,后续用上一页最后一条笔记的 ID。",
143
+ description: "获取笔记列表(每次固定返回 20 条,服务端不支持 limit 参数)。用游标翻页:首次请求不传 cursor;后续把上一次响应返回的 cursor 字段原样传入,直到 has_more 为 false。响应里的 total 是全库笔记总数,不是本页条数。",
134
144
  inputSchema: {
135
145
  type: "object",
136
146
  properties: {
137
- since_id: {
147
+ cursor: {
138
148
  type: "string",
139
- description: "翻页游标。首次不传(或传 \"0\"),后续将上一次响应的 cursor 字段直接传入即可,无需任何转换",
149
+ description: "翻页游标。首次不传;后续将上一次响应的 cursor 字段原样传入即可,无需任何转换。",
140
150
  },
141
151
  },
142
152
  required: [],
@@ -149,8 +159,8 @@ const TOOLS = [
149
159
  type: "object",
150
160
  properties: {
151
161
  id: {
152
- type: ["number", "string"],
153
- description: "笔记 ID",
162
+ type: ["string", "number"],
163
+ description: "笔记 ID。必须优先传十进制字符串;仅为兼容旧调用接受 JavaScript 安全整数",
154
164
  },
155
165
  image_quality: {
156
166
  type: "string",
@@ -187,8 +197,16 @@ const TOOLS = [
187
197
  description: "标签列表(最多 5 个,每个不超过 10 个汉字)",
188
198
  },
189
199
  parent_id: {
190
- type: ["number", "string"],
191
- description: "父笔记 ID(创建子笔记时填,父笔记的 is_child_note 必须为 false)",
200
+ type: ["string", "number"],
201
+ description: "父笔记 ID(优先传十进制字符串;创建子笔记时填,父笔记的 is_child_note 必须为 false)",
202
+ },
203
+ topic_id: {
204
+ type: "string",
205
+ description: "目标知识库 ID(来自 list_topics 的 topic_id;支持 DEFAULT、BOOKSPACE、CUSTOMER)",
206
+ },
207
+ client_request_id: {
208
+ type: "string",
209
+ description: "可选幂等键(1-128 个 ASCII 字符)。重试同一创建请求时必须复用同一个值",
192
210
  },
193
211
  link_url: {
194
212
  type: "string",
@@ -224,8 +242,8 @@ const TOOLS = [
224
242
  type: "object",
225
243
  properties: {
226
244
  note_id: {
227
- type: ["number", "string"],
228
- description: "笔记 ID",
245
+ type: ["string", "number"],
246
+ description: "笔记 ID。必须优先传十进制字符串;仅兼容 JavaScript 安全整数",
229
247
  },
230
248
  },
231
249
  required: ["note_id"],
@@ -238,8 +256,8 @@ const TOOLS = [
238
256
  type: "object",
239
257
  properties: {
240
258
  note_id: {
241
- type: ["number", "string"],
242
- description: "笔记 ID(必填)",
259
+ type: ["string", "number"],
260
+ description: "笔记 ID(必填,优先传十进制字符串)",
243
261
  },
244
262
  title: {
245
263
  type: "string",
@@ -266,8 +284,8 @@ const TOOLS = [
266
284
  type: "object",
267
285
  properties: {
268
286
  note_id: {
269
- type: ["number", "string"],
270
- description: "笔记 ID",
287
+ type: ["string", "number"],
288
+ description: "笔记 ID(优先传十进制字符串)",
271
289
  },
272
290
  tags: {
273
291
  type: "array",
@@ -285,8 +303,8 @@ const TOOLS = [
285
303
  type: "object",
286
304
  properties: {
287
305
  note_id: {
288
- type: ["number", "string"],
289
- description: "笔记 ID",
306
+ type: ["string", "number"],
307
+ description: "笔记 ID(优先传十进制字符串)",
290
308
  },
291
309
  tag_id: {
292
310
  type: "string",
@@ -299,7 +317,7 @@ const TOOLS = [
299
317
  // ── Knowledge / Topics ──
300
318
  {
301
319
  name: "list_topics",
302
- description: "获取知识库列表(每页固定 20 条)。返回 topics[]、has_more、total。每个 topic 包含 topic_id(知识库 ID,后续所有接口的 topic_id 参数均传此值)、name、description、cover、stats(笔记数、文件数、博主数、直播数)等。",
320
+ description: "获取用户自己创建或拥有的知识库列表(每页固定 20 条),包含普通知识库(DEFAULT)、客户档案(CUSTOMER)和书籍知识库(BOOKSPACE)。返回 topics[]、has_more、total;保存笔记前可先按 name/scope 选择目标 topic_id。",
303
321
  inputSchema: {
304
322
  type: "object",
305
323
  properties: {
@@ -474,8 +492,8 @@ const TOOLS = [
474
492
  description: "知识库 ID(来自 list_topics 的 topic_id 字段)",
475
493
  },
476
494
  follow_id: {
477
- type: "number",
478
- description: "博主订阅 ID(来自 list_topic_bloggers 的 follow_id 字段)",
495
+ type: ["string", "number"],
496
+ description: "博主订阅 ID(优先使用 list_topic_bloggers 返回的 follow_id_str;兼容安全整数 follow_id)",
479
497
  },
480
498
  page: {
481
499
  type: "number",
@@ -533,8 +551,8 @@ const TOOLS = [
533
551
  description: "知识库 ID(来自 list_topics 的 topic_id 字段)",
534
552
  },
535
553
  live_id: {
536
- type: "number",
537
- description: "直播 ID(来自 list_topic_lives 的 live_id 字段)",
554
+ type: ["string", "number"],
555
+ description: "直播 ID(来自 list_topic_lives 的 live_id,优先按字符串原样传入)",
538
556
  },
539
557
  },
540
558
  required: ["topic_id", "live_id"],
@@ -542,7 +560,7 @@ const TOOLS = [
542
560
  },
543
561
  {
544
562
  name: "follow_topic_live",
545
- description: "订阅一个得到 App 直播到知识库。直播结束后经 AI 处理即可通过 list_topic_lives 查看。目前仅支持得到 App 直播链接。需要 topic.live.read scope。",
563
+ description: "订阅一个得到 App 直播到知识库。直播结束后经 AI 处理即可通过 list_topic_lives 查看。目前仅支持得到 App 直播链接。需要 topic.live.write scope。",
546
564
  inputSchema: {
547
565
  type: "object",
548
566
  properties: {
@@ -561,7 +579,7 @@ const TOOLS = [
561
579
  // ── Note / Sharing ──
562
580
  {
563
581
  name: "share_note",
564
- description: "生成笔记的公开分享链接。幂等接口,多次调用返回同一个 share_url。需要 note.content.read scope。",
582
+ description: "生成笔记的公开分享链接。幂等接口,多次调用返回同一个 share_url。需要 note.sharing.write scope。",
565
583
  inputSchema: {
566
584
  type: "object",
567
585
  properties: {
@@ -650,11 +668,11 @@ async function handleTool(name, input, client) {
650
668
  switch (name) {
651
669
  // ── Notes ──
652
670
  case "list_notes": {
653
- const since_id = input.since_id;
654
- return client.listNotes({ cursor: since_id === "0" ? undefined : since_id });
671
+ const cursor = input.cursor;
672
+ return client.listNotes({ cursor: cursor === "0" ? undefined : cursor });
655
673
  }
656
674
  case "get_note": {
657
- return client.getNote(input.id, input.image_quality);
675
+ return client.getNote(snowflakeID(input.id, "id"), input.image_quality);
658
676
  }
659
677
  case "save_note": {
660
678
  const body = {};
@@ -667,7 +685,11 @@ async function handleTool(name, input, client) {
667
685
  if (input.tags !== undefined)
668
686
  body.tags = input.tags;
669
687
  if (input.parent_id !== undefined)
670
- body.parent_id = input.parent_id;
688
+ body.parent_id = snowflakeID(input.parent_id, "parent_id");
689
+ if (input.topic_id !== undefined)
690
+ body.topic_id = input.topic_id;
691
+ if (input.client_request_id !== undefined)
692
+ body.client_request_id = input.client_request_id;
671
693
  if (input.link_url !== undefined)
672
694
  body.link_url = input.link_url;
673
695
  if (input.image_urls !== undefined)
@@ -675,11 +697,11 @@ async function handleTool(name, input, client) {
675
697
  return client.saveNote(body);
676
698
  }
677
699
  case "delete_note": {
678
- return client.deleteNote(input.note_id);
700
+ return client.deleteNote(snowflakeID(input.note_id, "note_id"));
679
701
  }
680
702
  case "update_note": {
681
703
  const body = {
682
- note_id: input.note_id,
704
+ note_id: snowflakeID(input.note_id, "note_id"),
683
705
  };
684
706
  if (input.title !== undefined)
685
707
  body.title = input.title;
@@ -694,10 +716,10 @@ async function handleTool(name, input, client) {
694
716
  }
695
717
  // ── Tags ──
696
718
  case "add_note_tags": {
697
- return client.addNoteTags(input.note_id, input.tags);
719
+ return client.addNoteTags(snowflakeID(input.note_id, "note_id"), input.tags);
698
720
  }
699
721
  case "delete_note_tag": {
700
- return client.deleteNoteTag(input.note_id, input.tag_id);
722
+ return client.deleteNoteTag(snowflakeID(input.note_id, "note_id"), input.tag_id);
701
723
  }
702
724
  // ── Knowledge ──
703
725
  case "list_topics": {
@@ -721,13 +743,13 @@ async function handleTool(name, input, client) {
721
743
  case "batch_add_notes_to_topic": {
722
744
  return client.batchAddNotesToTopic({
723
745
  topic_id: input.topic_id,
724
- note_ids: input.note_ids.map(String),
746
+ note_ids: input.note_ids.map((id) => String(snowflakeID(id, "note_ids[]"))),
725
747
  });
726
748
  }
727
749
  case "remove_note_from_topic": {
728
750
  return client.removeNoteFromTopic({
729
751
  topic_id: input.topic_id,
730
- note_ids: input.note_ids.map(String),
752
+ note_ids: input.note_ids.map((id) => String(snowflakeID(id, "note_ids[]"))),
731
753
  });
732
754
  }
733
755
  // ── Image ──
@@ -774,7 +796,7 @@ async function handleTool(name, input, client) {
774
796
  case "list_topic_blogger_contents": {
775
797
  return client.listTopicBloggerContents({
776
798
  topic_id: input.topic_id,
777
- follow_id: input.follow_id,
799
+ follow_id: snowflakeID(input.follow_id, "follow_id"),
778
800
  page: input.page,
779
801
  });
780
802
  }
@@ -794,7 +816,7 @@ async function handleTool(name, input, client) {
794
816
  case "get_live_detail": {
795
817
  return client.getLiveDetail({
796
818
  topic_id: input.topic_id,
797
- live_id: input.live_id,
819
+ live_id: snowflakeID(input.live_id, "live_id"),
798
820
  });
799
821
  }
800
822
  case "follow_topic_live": {
@@ -878,9 +900,13 @@ async function main() {
878
900
  reason: err.reason,
879
901
  message: err.message,
880
902
  request_id: err.requestId,
903
+ retryable: err.retryable,
904
+ field: err.field,
905
+ constraint: err.constraint,
906
+ expected_type: err.expectedType,
881
907
  };
882
908
  if (err.code === 10201) {
883
- errPayload.membership_url = "https://www.biji.com/checkout?product_alias=9Ab36BB3ZD&spm=wangye";
909
+ errPayload.membership_url = membership_js_1.OPENAPI_MEMBERSHIP_PURCHASE_URL;
884
910
  }
885
911
  return {
886
912
  content: [
@@ -0,0 +1,2 @@
1
+ export declare const OPENAPI_MEMBERSHIP_PURCHASE_URL = "https://www.biji.com/checkout?product_alias=9Ab36BB3ZD&spm=openapi_mcp";
2
+ //# sourceMappingURL=membership.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"membership.d.ts","sourceRoot":"","sources":["../src/membership.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,+BAA+B,2EAC8B,CAAC"}
@@ -0,0 +1,5 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.OPENAPI_MEMBERSHIP_PURCHASE_URL = void 0;
4
+ exports.OPENAPI_MEMBERSHIP_PURCHASE_URL = "https://www.biji.com/checkout?product_alias=9Ab36BB3ZD&spm=openapi_mcp";
5
+ //# sourceMappingURL=membership.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@getnote/mcp",
3
- "version": "1.5.2",
3
+ "version": "1.6.0",
4
4
  "description": "MCP server for 得到大脑(Get笔记) — manage notes and knowledge bases from AI assistants",
5
5
  "main": "dist/index.js",
6
6
  "bin": {
@@ -10,7 +10,8 @@
10
10
  "build": "tsc",
11
11
  "dev": "ts-node src/index.ts",
12
12
  "start": "node dist/index.js",
13
- "prepare": "npm run build"
13
+ "prepare": "npm run build",
14
+ "test": "npm run build && node --test test/*.test.mjs"
14
15
  },
15
16
  "keywords": [
16
17
  "mcp",
@@ -43,4 +44,4 @@
43
44
  "axios": "^1.16.1",
44
45
  "qs": "^6.15.2"
45
46
  }
46
- }
47
+ }
package/src/client.ts CHANGED
@@ -1,6 +1,13 @@
1
1
  import axios, { AxiosInstance, AxiosError } from "axios";
2
2
 
3
- const BASE_URL = "https://openapi.biji.com/open/api/v1";
3
+ const DEFAULT_BASE_URL = "https://openapi.biji.com/open/api/v1";
4
+
5
+ function normalizeBaseURL(value?: string): string {
6
+ const base = (value || DEFAULT_BASE_URL).replace(/\/+$/, "");
7
+ if (base.endsWith("/open/api/v1")) return base;
8
+ if (base.endsWith("/open")) return `${base}/api/v1`;
9
+ return `${base}/open/api/v1`;
10
+ }
4
11
 
5
12
  /**
6
13
  * Preserves long-integer ID fields as JSON strings before JSON.parse, so JS
@@ -12,11 +19,14 @@ const BASE_URL = "https://openapi.biji.com/open/api/v1";
12
19
  * Matches only when the captured field value has 16+ digits, so short IDs
13
20
  * remain numbers.
14
21
  */
15
- function parseJsonPreservingLargeIntegerStrings(data: unknown) {
22
+ export function parseJsonPreservingLargeIntegerStrings(data: unknown) {
16
23
  if (typeof data !== "string" || data.trim() === "") return data;
17
24
  const safe = data.replace(
18
- /"(note_id|next_cursor|cursor|id|parent_id|topic_id|since_id|share_id)"\s*:\s*(\d{16,})/g,
25
+ /"(note_id|next_cursor|cursor|id|parent_id|topic_id|since_id|share_id|follow_id|live_id)"\s*:\s*(\d{16,})/g,
19
26
  '"$1":"$2"'
27
+ ).replace(
28
+ /([:[,]\s*)(-?\d{16,})(?=\s*[,}\]])/g,
29
+ '$1"$2"'
20
30
  );
21
31
  return JSON.parse(safe);
22
32
  }
@@ -26,7 +36,11 @@ export class GetNoteAPIError extends Error {
26
36
  public readonly code: number,
27
37
  public readonly reason: string,
28
38
  message: string,
29
- public readonly requestId?: string
39
+ public readonly requestId?: string,
40
+ public readonly retryable: boolean = false,
41
+ public readonly field?: string,
42
+ public readonly constraint?: string,
43
+ public readonly expectedType?: string
30
44
  ) {
31
45
  super(message);
32
46
  this.name = "GetNoteAPIError";
@@ -36,9 +50,9 @@ export class GetNoteAPIError extends Error {
36
50
  export class GetNoteClient {
37
51
  private http: AxiosInstance;
38
52
 
39
- constructor(apiKey: string, clientId: string) {
53
+ constructor(apiKey: string, clientId: string, baseURL?: string) {
40
54
  this.http = axios.create({
41
- baseURL: BASE_URL,
55
+ baseURL: normalizeBaseURL(baseURL || process.env.GETNOTE_API_URL),
42
56
  headers: {
43
57
  Authorization: `Bearer ${apiKey}`,
44
58
  "X-Client-ID": clientId,
@@ -66,7 +80,7 @@ export class GetNoteClient {
66
80
  const res = await this.http.request<{
67
81
  success: boolean;
68
82
  data: T;
69
- error?: { code: number; message: string; reason: string };
83
+ error?: APIErrorBody;
70
84
  request_id?: string;
71
85
  }>({
72
86
  method,
@@ -82,7 +96,11 @@ export class GetNoteClient {
82
96
  err?.code ?? -1,
83
97
  err?.reason ?? "unknown",
84
98
  err?.message ?? "API request failed",
85
- body.request_id
99
+ body.request_id,
100
+ err?.retryable ?? false,
101
+ err?.field,
102
+ err?.constraint,
103
+ err?.expected_type
86
104
  );
87
105
  }
88
106
 
@@ -93,7 +111,7 @@ export class GetNoteClient {
93
111
  if (axios.isAxiosError(err) && err.response) {
94
112
  const body = err.response.data as {
95
113
  success?: boolean;
96
- error?: { code: number; message: string; reason: string };
114
+ error?: APIErrorBody;
97
115
  request_id?: string;
98
116
  };
99
117
  if (body?.error) {
@@ -101,7 +119,11 @@ export class GetNoteClient {
101
119
  body.error.code,
102
120
  body.error.reason,
103
121
  body.error.message,
104
- body.request_id
122
+ body.request_id,
123
+ body.error.retryable ?? false,
124
+ body.error.field,
125
+ body.error.constraint,
126
+ body.error.expected_type
105
127
  );
106
128
  }
107
129
  throw new Error(`HTTP ${err.response.status}: ${err.message}`);
@@ -119,7 +141,7 @@ export class GetNoteClient {
119
141
  });
120
142
  }
121
143
 
122
- async getNote(id: number | string, image_quality?: string) {
144
+ async getNote(id: string | number, image_quality?: string) {
123
145
  return this.request<GetNoteResp>("GET", "/resource/note/detail", { id, image_quality });
124
146
  }
125
147
 
@@ -198,29 +220,29 @@ export class GetNoteClient {
198
220
  const FormData = (await import("form-data")).default;
199
221
  const form = new FormData();
200
222
 
223
+ form.append("key", token.object_key);
201
224
  form.append("OSSAccessKeyId", token.accessid);
202
225
  form.append("policy", token.policy);
203
- form.append("Signature", token.signature);
204
- form.append("key", token.object_key);
226
+ form.append("signature", token.signature);
205
227
  form.append("callback", token.callback);
206
- form.append("success_action_status", "200");
228
+ form.append("Content-Type", token.oss_content_type);
207
229
  form.append("file", imageData, {
208
230
  filename: "image",
209
231
  contentType: token.oss_content_type,
210
232
  });
211
233
 
212
- const response = await fetch(token.host, {
213
- method: "POST",
214
- body: form as unknown as BodyInit,
234
+ const response = await axios.post(token.host, form, {
215
235
  headers: form.getHeaders(),
236
+ maxBodyLength: Infinity,
237
+ validateStatus: () => true,
216
238
  });
217
239
 
218
- if (!response.ok) {
240
+ if (response.status < 200 || response.status >= 300) {
219
241
  throw new Error(`OSS upload failed: ${response.status}`);
220
242
  }
221
243
 
222
244
  // 解析回调响应: {"h":{"c":0},"c":{"image":{"id":"xxx"}}}
223
- const result = await response.json() as { h: { c: number }; c: { image: { id: string } } };
245
+ const result = response.data as { h: { c: number }; c: { image: { id: string } } };
224
246
  if (result.h?.c !== 0) {
225
247
  throw new Error("OSS callback failed");
226
248
  }
@@ -454,12 +476,13 @@ export interface GetNoteResp {
454
476
  }
455
477
 
456
478
  export interface SaveNoteReq {
457
- id?: number | string;
458
479
  title?: string;
459
480
  content?: string;
460
481
  note_type?: "plain_text" | "link" | "img_text";
461
482
  tags?: string[];
462
- parent_id?: number | string;
483
+ topic_id?: string;
484
+ parent_id?: string | number;
485
+ client_request_id?: string;
463
486
  link_url?: string;
464
487
  image_urls?: string[];
465
488
  }
@@ -472,11 +495,15 @@ export interface NoteTaskItem {
472
495
  }
473
496
 
474
497
  export interface SaveNoteResp {
475
- id: string;
476
- title: string;
477
- created_at: string;
478
- updated_at: string;
498
+ /** Legacy numeric field; transformed to a string when it exceeds JS safe range. */
499
+ id?: string | number;
500
+ /** Canonical lossless note ID. */
501
+ note_id?: string;
502
+ title?: string;
503
+ created_at?: string;
504
+ updated_at?: string;
479
505
  message?: string;
506
+ result?: "created" | "accepted";
480
507
  /** 链接笔记创建时返回的任务列表 */
481
508
  tasks?: NoteTaskItem[];
482
509
  /** 成功创建的笔记数量 */
@@ -485,6 +512,8 @@ export interface SaveNoteResp {
485
512
  duplicate_count?: number;
486
513
  /** 无效的链接数量 */
487
514
  invalid_count?: number;
515
+ duplicate_urls?: string[];
516
+ invalid_urls?: string[];
488
517
  }
489
518
 
490
519
  export interface NoteTaskProgress {
@@ -521,7 +550,6 @@ export interface DeleteNoteTagResp {
521
550
  export interface GetUploadConfigResp {
522
551
  support_extensions: string[];
523
552
  max_size_bytes: number;
524
- max_count: number;
525
553
  }
526
554
 
527
555
  // OSS 上传凭证(与 Web 端格式一致)
@@ -578,7 +606,7 @@ export interface TopicNoteItem {
578
606
  content: string;
579
607
  note_type: string;
580
608
  tags: string[];
581
- is_ai?: boolean;
609
+ is_ai_generated?: boolean;
582
610
  created_at: string;
583
611
  edit_time: string;
584
612
  }
@@ -621,7 +649,8 @@ export interface GetQuotaResp {
621
649
  // ─── Blogger Types ───────────────────────────────────────────────────────────
622
650
 
623
651
  export interface BloggerItem {
624
- follow_id: number;
652
+ follow_id: string | number;
653
+ follow_id_str?: string;
625
654
  account_name: string;
626
655
  account_avatar: string;
627
656
  notes_count: number;
@@ -664,8 +693,9 @@ export interface BloggerContentDetail extends BloggerContentItem {
664
693
  // ─── Live Types ──────────────────────────────────────────────────────────────
665
694
 
666
695
  export interface LiveItem {
667
- live_id: string | number; // API may return string or number
668
- follow_id: number;
696
+ live_id: string;
697
+ follow_id: string | number;
698
+ follow_id_str?: string;
669
699
  name: string;
670
700
  cover: string;
671
701
  sub_title: string;
@@ -698,7 +728,8 @@ export interface LiveDetail {
698
728
  // ─── Follow Topic Live Types ─────────────────────────────────────────────────
699
729
 
700
730
  export interface FollowTopicLiveResp {
701
- follow_id: number;
731
+ follow_id: string | number;
732
+ follow_id_str?: string;
702
733
  url: string;
703
734
  platform: string;
704
735
  type: string;
@@ -730,6 +761,16 @@ export interface UpdateNoteReq {
730
761
  tags?: string[];
731
762
  }
732
763
 
764
+ interface APIErrorBody {
765
+ code: number;
766
+ message: string;
767
+ reason: string;
768
+ retryable?: boolean;
769
+ field?: string;
770
+ constraint?: string;
771
+ expected_type?: string;
772
+ }
773
+
733
774
  export interface UpdateNoteResp {
734
775
  note_id: string;
735
776
  title: string;
package/src/index.ts CHANGED
@@ -16,6 +16,7 @@ import {
16
16
  } from "@modelcontextprotocol/sdk/types.js";
17
17
  import { z } from "zod";
18
18
  import { GetNoteClient, GetNoteAPIError, SaveNoteReq, UpdateNoteReq } from "./client.js";
19
+ import { OPENAPI_MEMBERSHIP_PURCHASE_URL } from "./membership.js";
19
20
  import { readFileSync, realpathSync } from "node:fs";
20
21
  import { join, resolve, isAbsolute, sep } from "node:path";
21
22
 
@@ -115,6 +116,18 @@ function getClientId(): string {
115
116
  process.exit(1);
116
117
  }
117
118
 
119
+ function snowflakeID(value: unknown, field: string): string | number {
120
+ if (typeof value === "string" && /^\d+$/.test(value)) {
121
+ return value;
122
+ }
123
+ if (typeof value === "number" && Number.isSafeInteger(value) && value >= 0) {
124
+ return value;
125
+ }
126
+ throw new Error(
127
+ `${field} must be a decimal string; only legacy integers within JavaScript's safe range are accepted`
128
+ );
129
+ }
130
+
118
131
  // ─── Tool Definitions ────────────────────────────────────────────────────────
119
132
 
120
133
  const TOOLS: Tool[] = [
@@ -122,13 +135,13 @@ const TOOLS: Tool[] = [
122
135
  {
123
136
  name: "list_notes",
124
137
  description:
125
- "获取笔记列表(每次固定返回 20 条)。首次请求 since_id 传 0,后续用上一页最后一条笔记的 ID。",
138
+ "获取笔记列表(每次固定返回 20 条,服务端不支持 limit 参数)。用游标翻页:首次请求不传 cursor;后续把上一次响应返回的 cursor 字段原样传入,直到 has_more 为 false。响应里的 total 是全库笔记总数,不是本页条数。",
126
139
  inputSchema: {
127
140
  type: "object" as const,
128
141
  properties: {
129
- since_id: {
142
+ cursor: {
130
143
  type: "string",
131
- description: "翻页游标。首次不传(或传 \"0\"),后续将上一次响应的 cursor 字段直接传入即可,无需任何转换",
144
+ description: "翻页游标。首次不传;后续将上一次响应的 cursor 字段原样传入即可,无需任何转换。",
132
145
  },
133
146
  },
134
147
  required: [],
@@ -141,8 +154,8 @@ const TOOLS: Tool[] = [
141
154
  type: "object" as const,
142
155
  properties: {
143
156
  id: {
144
- type: ["number", "string"],
145
- description: "笔记 ID",
157
+ type: ["string", "number"],
158
+ description: "笔记 ID。必须优先传十进制字符串;仅为兼容旧调用接受 JavaScript 安全整数",
146
159
  },
147
160
  image_quality: {
148
161
  type: "string",
@@ -180,8 +193,16 @@ const TOOLS: Tool[] = [
180
193
  description: "标签列表(最多 5 个,每个不超过 10 个汉字)",
181
194
  },
182
195
  parent_id: {
183
- type: ["number", "string"],
184
- description: "父笔记 ID(创建子笔记时填,父笔记的 is_child_note 必须为 false)",
196
+ type: ["string", "number"],
197
+ description: "父笔记 ID(优先传十进制字符串;创建子笔记时填,父笔记的 is_child_note 必须为 false)",
198
+ },
199
+ topic_id: {
200
+ type: "string",
201
+ description: "目标知识库 ID(来自 list_topics 的 topic_id;支持 DEFAULT、BOOKSPACE、CUSTOMER)",
202
+ },
203
+ client_request_id: {
204
+ type: "string",
205
+ description: "可选幂等键(1-128 个 ASCII 字符)。重试同一创建请求时必须复用同一个值",
185
206
  },
186
207
  link_url: {
187
208
  type: "string",
@@ -218,8 +239,8 @@ const TOOLS: Tool[] = [
218
239
  type: "object" as const,
219
240
  properties: {
220
241
  note_id: {
221
- type: ["number", "string"],
222
- description: "笔记 ID",
242
+ type: ["string", "number"],
243
+ description: "笔记 ID。必须优先传十进制字符串;仅兼容 JavaScript 安全整数",
223
244
  },
224
245
  },
225
246
  required: ["note_id"],
@@ -233,8 +254,8 @@ const TOOLS: Tool[] = [
233
254
  type: "object" as const,
234
255
  properties: {
235
256
  note_id: {
236
- type: ["number", "string"],
237
- description: "笔记 ID(必填)",
257
+ type: ["string", "number"],
258
+ description: "笔记 ID(必填,优先传十进制字符串)",
238
259
  },
239
260
  title: {
240
261
  type: "string",
@@ -262,8 +283,8 @@ const TOOLS: Tool[] = [
262
283
  type: "object" as const,
263
284
  properties: {
264
285
  note_id: {
265
- type: ["number", "string"],
266
- description: "笔记 ID",
286
+ type: ["string", "number"],
287
+ description: "笔记 ID(优先传十进制字符串)",
267
288
  },
268
289
  tags: {
269
290
  type: "array",
@@ -281,8 +302,8 @@ const TOOLS: Tool[] = [
281
302
  type: "object" as const,
282
303
  properties: {
283
304
  note_id: {
284
- type: ["number", "string"],
285
- description: "笔记 ID",
305
+ type: ["string", "number"],
306
+ description: "笔记 ID(优先传十进制字符串)",
286
307
  },
287
308
  tag_id: {
288
309
  type: "string",
@@ -296,7 +317,7 @@ const TOOLS: Tool[] = [
296
317
  // ── Knowledge / Topics ──
297
318
  {
298
319
  name: "list_topics",
299
- description: "获取知识库列表(每页固定 20 条)。返回 topics[]、has_more、total。每个 topic 包含 topic_id(知识库 ID,后续所有接口的 topic_id 参数均传此值)、name、description、cover、stats(笔记数、文件数、博主数、直播数)等。",
320
+ description: "获取用户自己创建或拥有的知识库列表(每页固定 20 条),包含普通知识库(DEFAULT)、客户档案(CUSTOMER)和书籍知识库(BOOKSPACE)。返回 topics[]、has_more、total;保存笔记前可先按 name/scope 选择目标 topic_id。",
300
321
  inputSchema: {
301
322
  type: "object" as const,
302
323
  properties: {
@@ -479,8 +500,8 @@ const TOOLS: Tool[] = [
479
500
  description: "知识库 ID(来自 list_topics 的 topic_id 字段)",
480
501
  },
481
502
  follow_id: {
482
- type: "number",
483
- description: "博主订阅 ID(来自 list_topic_bloggers 的 follow_id 字段)",
503
+ type: ["string", "number"],
504
+ description: "博主订阅 ID(优先使用 list_topic_bloggers 返回的 follow_id_str;兼容安全整数 follow_id)",
484
505
  },
485
506
  page: {
486
507
  type: "number",
@@ -542,8 +563,8 @@ const TOOLS: Tool[] = [
542
563
  description: "知识库 ID(来自 list_topics 的 topic_id 字段)",
543
564
  },
544
565
  live_id: {
545
- type: "number",
546
- description: "直播 ID(来自 list_topic_lives 的 live_id 字段)",
566
+ type: ["string", "number"],
567
+ description: "直播 ID(来自 list_topic_lives 的 live_id,优先按字符串原样传入)",
547
568
  },
548
569
  },
549
570
  required: ["topic_id", "live_id"],
@@ -553,7 +574,7 @@ const TOOLS: Tool[] = [
553
574
  {
554
575
  name: "follow_topic_live",
555
576
  description:
556
- "订阅一个得到 App 直播到知识库。直播结束后经 AI 处理即可通过 list_topic_lives 查看。目前仅支持得到 App 直播链接。需要 topic.live.read scope。",
577
+ "订阅一个得到 App 直播到知识库。直播结束后经 AI 处理即可通过 list_topic_lives 查看。目前仅支持得到 App 直播链接。需要 topic.live.write scope。",
557
578
  inputSchema: {
558
579
  type: "object" as const,
559
580
  properties: {
@@ -574,7 +595,7 @@ const TOOLS: Tool[] = [
574
595
  {
575
596
  name: "share_note",
576
597
  description:
577
- "生成笔记的公开分享链接。幂等接口,多次调用返回同一个 share_url。需要 note.content.read scope。",
598
+ "生成笔记的公开分享链接。幂等接口,多次调用返回同一个 share_url。需要 note.sharing.write scope。",
578
599
  inputSchema: {
579
600
  type: "object" as const,
580
601
  properties: {
@@ -679,11 +700,11 @@ async function handleTool(
679
700
  switch (name) {
680
701
  // ── Notes ──
681
702
  case "list_notes": {
682
- const since_id = (input.since_id as string | undefined);
683
- return client.listNotes({ cursor: since_id === "0" ? undefined : since_id });
703
+ const cursor = (input.cursor as string | undefined);
704
+ return client.listNotes({ cursor: cursor === "0" ? undefined : cursor });
684
705
  }
685
706
  case "get_note": {
686
- return client.getNote(input.id as number | string, input.image_quality as string | undefined);
707
+ return client.getNote(snowflakeID(input.id, "id"), input.image_quality as string | undefined);
687
708
  }
688
709
  case "save_note": {
689
710
  const body: SaveNoteReq = {};
@@ -693,18 +714,21 @@ async function handleTool(
693
714
  body.note_type = input.note_type as SaveNoteReq["note_type"];
694
715
  if (input.tags !== undefined) body.tags = input.tags as string[];
695
716
  if (input.parent_id !== undefined)
696
- body.parent_id = input.parent_id as number | string;
717
+ body.parent_id = snowflakeID(input.parent_id, "parent_id");
718
+ if (input.topic_id !== undefined) body.topic_id = input.topic_id as string;
719
+ if (input.client_request_id !== undefined)
720
+ body.client_request_id = input.client_request_id as string;
697
721
  if (input.link_url !== undefined) body.link_url = input.link_url as string;
698
722
  if (input.image_urls !== undefined)
699
723
  body.image_urls = input.image_urls as string[];
700
724
  return client.saveNote(body);
701
725
  }
702
726
  case "delete_note": {
703
- return client.deleteNote(input.note_id as number | string);
727
+ return client.deleteNote(snowflakeID(input.note_id, "note_id"));
704
728
  }
705
729
  case "update_note": {
706
730
  const body: { note_id: number | string; title?: string; content?: string; tags?: string[] } = {
707
- note_id: input.note_id as number | string,
731
+ note_id: snowflakeID(input.note_id, "note_id"),
708
732
  };
709
733
  if (input.title !== undefined) body.title = input.title as string;
710
734
  if (input.content !== undefined) body.content = input.content as string;
@@ -718,13 +742,13 @@ async function handleTool(
718
742
  // ── Tags ──
719
743
  case "add_note_tags": {
720
744
  return client.addNoteTags(
721
- input.note_id as number | string,
745
+ snowflakeID(input.note_id, "note_id"),
722
746
  input.tags as string[]
723
747
  );
724
748
  }
725
749
  case "delete_note_tag": {
726
750
  return client.deleteNoteTag(
727
- input.note_id as number | string,
751
+ snowflakeID(input.note_id, "note_id"),
728
752
  input.tag_id as string
729
753
  );
730
754
  }
@@ -751,13 +775,13 @@ async function handleTool(
751
775
  case "batch_add_notes_to_topic": {
752
776
  return client.batchAddNotesToTopic({
753
777
  topic_id: input.topic_id as string,
754
- note_ids: (input.note_ids as (number | string)[]).map(String),
778
+ note_ids: (input.note_ids as unknown[]).map((id) => String(snowflakeID(id, "note_ids[]"))),
755
779
  });
756
780
  }
757
781
  case "remove_note_from_topic": {
758
782
  return client.removeNoteFromTopic({
759
783
  topic_id: input.topic_id as string,
760
- note_ids: (input.note_ids as (number | string)[]).map(String),
784
+ note_ids: (input.note_ids as unknown[]).map((id) => String(snowflakeID(id, "note_ids[]"))),
761
785
  });
762
786
  }
763
787
 
@@ -806,7 +830,7 @@ async function handleTool(
806
830
  case "list_topic_blogger_contents": {
807
831
  return client.listTopicBloggerContents({
808
832
  topic_id: input.topic_id as string,
809
- follow_id: input.follow_id as number | string,
833
+ follow_id: snowflakeID(input.follow_id, "follow_id"),
810
834
  page: input.page as number | undefined,
811
835
  });
812
836
  }
@@ -827,7 +851,7 @@ async function handleTool(
827
851
  case "get_live_detail": {
828
852
  return client.getLiveDetail({
829
853
  topic_id: input.topic_id as string,
830
- live_id: input.live_id as number | string,
854
+ live_id: snowflakeID(input.live_id, "live_id"),
831
855
  });
832
856
  }
833
857
 
@@ -925,9 +949,13 @@ async function main() {
925
949
  reason: err.reason,
926
950
  message: err.message,
927
951
  request_id: err.requestId,
952
+ retryable: err.retryable,
953
+ field: err.field,
954
+ constraint: err.constraint,
955
+ expected_type: err.expectedType,
928
956
  };
929
957
  if (err.code === 10201) {
930
- errPayload.membership_url = "https://www.biji.com/checkout?product_alias=9Ab36BB3ZD&spm=wangye";
958
+ errPayload.membership_url = OPENAPI_MEMBERSHIP_PURCHASE_URL;
931
959
  }
932
960
  return {
933
961
  content: [
@@ -0,0 +1,2 @@
1
+ export const OPENAPI_MEMBERSHIP_PURCHASE_URL =
2
+ "https://www.biji.com/checkout?product_alias=9Ab36BB3ZD&spm=openapi_mcp";
@@ -0,0 +1,122 @@
1
+ import assert from "node:assert/strict";
2
+ import http from "node:http";
3
+ import test from "node:test";
4
+
5
+ import {
6
+ GetNoteAPIError,
7
+ GetNoteClient,
8
+ parseJsonPreservingLargeIntegerStrings,
9
+ } from "../dist/client.js";
10
+ import { OPENAPI_MEMBERSHIP_PURCHASE_URL } from "../dist/membership.js";
11
+
12
+ test("membership errors use the MCP-specific OpenAPI purchase channel", () => {
13
+ assert.equal(
14
+ OPENAPI_MEMBERSHIP_PURCHASE_URL,
15
+ "https://www.biji.com/checkout?product_alias=9Ab36BB3ZD&spm=openapi_mcp"
16
+ );
17
+ });
18
+
19
+ test("large snowflake IDs are parsed and re-encoded as strings", () => {
20
+ const parsed = parseJsonPreservingLargeIntegerStrings(`{
21
+ "id": 1916020531058082912,
22
+ "follow_id": 1916020531058082913,
23
+ "children_ids": [1916020531058082914]
24
+ }`);
25
+ assert.equal(parsed.id, "1916020531058082912");
26
+ assert.equal(parsed.follow_id, "1916020531058082913");
27
+ assert.deepEqual(parsed.children_ids, ["1916020531058082914"]);
28
+ assert.match(JSON.stringify(parsed), /"1916020531058082912"/);
29
+ });
30
+
31
+ test("HTTP 200 success=false exposes the complete structured error", async () => {
32
+ const server = http.createServer((_req, res) => {
33
+ res.setHeader("content-type", "application/json");
34
+ res.end(JSON.stringify({
35
+ success: false,
36
+ data: null,
37
+ error: {
38
+ code: 10000,
39
+ message: "参数错误",
40
+ reason: "invalid_request",
41
+ retryable: false,
42
+ field: "parent_id",
43
+ constraint: "non_negative_decimal_integer",
44
+ expected_type: "decimal string or JSON integer",
45
+ },
46
+ request_id: "req_test",
47
+ }));
48
+ });
49
+ await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
50
+ const address = server.address();
51
+ const baseURL = `http://127.0.0.1:${address.port}`;
52
+
53
+ try {
54
+ await assert.rejects(
55
+ () => new GetNoteClient("key", "client", baseURL).getNote("1e3"),
56
+ (err) => {
57
+ assert.ok(err instanceof GetNoteAPIError);
58
+ assert.equal(err.field, "parent_id");
59
+ assert.equal(err.constraint, "non_negative_decimal_integer");
60
+ assert.equal(err.expectedType, "decimal string or JSON integer");
61
+ assert.equal(err.requestId, "req_test");
62
+ assert.equal(err.retryable, false);
63
+ return true;
64
+ }
65
+ );
66
+ } finally {
67
+ server.close();
68
+ }
69
+ });
70
+
71
+ test("OSS multipart fields use the signed names and order", async () => {
72
+ let body = "";
73
+ const server = http.createServer((req, res) => {
74
+ req.setEncoding("utf8");
75
+ req.on("data", (chunk) => {
76
+ body += chunk;
77
+ });
78
+ req.on("end", () => {
79
+ res.setHeader("content-type", "application/json");
80
+ res.end(JSON.stringify({ h: { c: 0 }, c: { image: { id: "img_1" } } }));
81
+ });
82
+ });
83
+ await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
84
+ const address = server.address();
85
+ const host = `http://127.0.0.1:${address.port}`;
86
+
87
+ try {
88
+ const client = new GetNoteClient("key", "client", host);
89
+ const result = await client.uploadImageToOSS({
90
+ accessid: "access",
91
+ host,
92
+ policy: "policy",
93
+ signature: "signature",
94
+ expire: 0,
95
+ callback: "callback",
96
+ object_key: "object",
97
+ access_url: "https://example.test/object",
98
+ oss_content_type: "image/png",
99
+ }, Buffer.from("image"));
100
+ assert.equal(result.image_id, "img_1");
101
+
102
+ const names = [
103
+ 'name="key"',
104
+ 'name="OSSAccessKeyId"',
105
+ 'name="policy"',
106
+ 'name="signature"',
107
+ 'name="callback"',
108
+ 'name="Content-Type"',
109
+ 'name="file"',
110
+ ];
111
+ let previous = -1;
112
+ for (const name of names) {
113
+ const current = body.indexOf(name);
114
+ assert.ok(current > previous, `${name} must follow the previous signed field`);
115
+ previous = current;
116
+ }
117
+ assert.equal(body.includes('name="Signature"'), false);
118
+ assert.equal(body.includes('name="success_action_status"'), false);
119
+ } finally {
120
+ server.close();
121
+ }
122
+ });