@getnote/mcp 1.3.1 → 1.4.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 +53 -8
- package/dist/client.d.ts +27 -12
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +17 -0
- package/package.json +4 -4
- package/src/client.ts +48 -12
package/README.md
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
[](https://mseep.ai/app/iswalle-getnote-mcp)
|
|
2
|
+
|
|
1
3
|
# getnote-mcp
|
|
2
4
|
|
|
3
5
|
MCP (Model Context Protocol) server for [Get笔记](https://biji.com) Open API.
|
|
@@ -46,25 +48,29 @@ Exposes the following tools to AI models:
|
|
|
46
48
|
| `list_topic_lives` | 获取知识库已完成直播列表 |
|
|
47
49
|
| `get_live_detail` | 获取直播详情(含 AI 摘要和原文转写) |
|
|
48
50
|
| `get_quota` | 查询 API 调用配额 |
|
|
51
|
+
| `share_note` | 生成笔记分享链接 |
|
|
52
|
+
| `follow_topic_live` | 在知识库里订阅得到直播 |
|
|
53
|
+
| `list_subscribe_topics` | 获取我订阅的知识库列表 |
|
|
49
54
|
|
|
50
55
|
## Installation
|
|
51
56
|
|
|
52
57
|
```bash
|
|
53
|
-
|
|
54
|
-
|
|
58
|
+
# 直接运行(推荐,无需克隆)
|
|
59
|
+
npx @getnote/mcp
|
|
60
|
+
|
|
61
|
+
# 或全局安装
|
|
62
|
+
npm install -g @getnote/mcp
|
|
55
63
|
```
|
|
56
64
|
|
|
57
65
|
## Usage
|
|
58
66
|
|
|
59
|
-
###
|
|
67
|
+
### 授权登录(推荐)
|
|
60
68
|
|
|
61
|
-
|
|
69
|
+
首次使用时,在 AI 对话里说「请帮我授权 Get笔记」,AI 会自动引导 OAuth 登录,无需手动配置。
|
|
62
70
|
|
|
63
|
-
|
|
71
|
+
### 手动配置 API Key(备选)
|
|
64
72
|
|
|
65
|
-
|
|
66
|
-
2. **MCP 配置文件**:添加到 Claude Desktop 或其他 MCP 客户端的配置
|
|
67
|
-
3. **项目 .env 文件**:在项目目录创建 `.env` 文件
|
|
73
|
+
获取 API Key 和 Client ID:**https://www.biji.com/openapi**
|
|
68
74
|
|
|
69
75
|
### Environment variable
|
|
70
76
|
|
|
@@ -185,6 +191,45 @@ Input: {
|
|
|
185
191
|
|
|
186
192
|
Get your API Key and Client ID at [Get笔记开放平台](https://www.biji.com/openapi).
|
|
187
193
|
|
|
194
|
+
## 🚀 进阶用法:用笔记内链实践柳比歇夫时间日志法
|
|
195
|
+
|
|
196
|
+
柳比歇夫时间日志法的核心是**每天记录自己把时间花在了哪里**,事后统计、复盘、改进。
|
|
197
|
+
|
|
198
|
+
结合 Get笔记内链,AI 可以帮你自动串联:
|
|
199
|
+
|
|
200
|
+
**每天早上**
|
|
201
|
+
|
|
202
|
+
> 👤 帮我记一条今日工作日志,内链到「产品设计方案」和「客户反馈」这两条笔记
|
|
203
|
+
>
|
|
204
|
+
> 🤖 已记录「2026-04-24 工作日志」,正文已插入两条内链。
|
|
205
|
+
|
|
206
|
+
**每周复盘**
|
|
207
|
+
|
|
208
|
+
> 👤 找找我这周的工作日志,整理一下时间分配
|
|
209
|
+
>
|
|
210
|
+
> 🤖 找到 5 条日志,你这周:产品设计 12h、客户沟通 6h、开会 4h……
|
|
211
|
+
|
|
212
|
+
**内链格式**:在笔记正文里用 `https://biji.com/note/{note_id}` 引用其他笔记。示例:
|
|
213
|
+
|
|
214
|
+
```
|
|
215
|
+
参考上次的讨论:https://biji.com/note/1234567890000000001
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
告诉 AI 要内链到哪条笔记,AI 会自动获取对应 note_id 插入。
|
|
219
|
+
|
|
220
|
+
---
|
|
221
|
+
|
|
222
|
+
## 🆕 更新日志
|
|
223
|
+
|
|
224
|
+
| 日期 | 版本 | 新能力 | 适合怎么用 |
|
|
225
|
+
|------|------|--------|------------|
|
|
226
|
+
| 2026-04-23 | **v1.3.1** | 1. 笔记内链<br>2. 保存分享链接自动变笔记 | 1. 用内链串联每天的工作日志和项目笔记,实践时间日志法<br>2. 收到别人发来的分享链接直接存入笔记 |
|
|
227
|
+
| 2026-04-16 | **v1.3.0** | 1. 生成笔记分享链接<br>2. 知识库订阅得到直播 | 1. 把笔记一键分享给朋友<br>2. 在知识库里订阅得到直播课,直播结束后 AI 摘要自动入库 |
|
|
228
|
+
| 2026-03-23 | **v1.2.x** | 获取我订阅的知识库,支持语义搜索 | 开通了某个知识库,可以直接问 AI:「在我订阅的 XXX 知识库里搜一下时间管理」 |
|
|
229
|
+
| 2026-03-12 | **v1.2.0** | 查看订阅博主内容、直播摘要和转写原文 | 把别人的知识变成自己可检索的笔记库 |
|
|
230
|
+
|
|
231
|
+
---
|
|
232
|
+
|
|
188
233
|
## License
|
|
189
234
|
|
|
190
235
|
MIT
|
package/dist/client.d.ts
CHANGED
|
@@ -113,14 +113,18 @@ export interface TagInfo {
|
|
|
113
113
|
type: "ai" | "manual" | "system";
|
|
114
114
|
}
|
|
115
115
|
export interface NoteItem {
|
|
116
|
-
|
|
116
|
+
/**
|
|
117
|
+
* Note ID. Returned as string because the actual values exceed
|
|
118
|
+
* Number.MAX_SAFE_INTEGER. See parseJsonPreservingLargeIntegerStrings.
|
|
119
|
+
*/
|
|
120
|
+
id: string;
|
|
117
121
|
title: string;
|
|
118
122
|
content: string;
|
|
119
123
|
ref_content?: string;
|
|
120
124
|
note_type: string;
|
|
121
125
|
source: string;
|
|
122
126
|
tags: TagInfo[];
|
|
123
|
-
parent_id?:
|
|
127
|
+
parent_id?: string;
|
|
124
128
|
children_count?: number;
|
|
125
129
|
topics?: {
|
|
126
130
|
id: string;
|
|
@@ -158,7 +162,11 @@ export interface NoteDetail extends NoteItem {
|
|
|
158
162
|
export interface ListNotesResp {
|
|
159
163
|
notes: NoteItem[];
|
|
160
164
|
has_more: boolean;
|
|
161
|
-
|
|
165
|
+
/**
|
|
166
|
+
* Cursor for the next page. Pass it back as `since_id` on the next call.
|
|
167
|
+
* Returned as string because IDs exceed Number.MAX_SAFE_INTEGER.
|
|
168
|
+
*/
|
|
169
|
+
next_cursor?: string;
|
|
162
170
|
total: number;
|
|
163
171
|
}
|
|
164
172
|
export interface GetNoteResp {
|
|
@@ -181,7 +189,7 @@ export interface NoteTaskItem {
|
|
|
181
189
|
url: string;
|
|
182
190
|
}
|
|
183
191
|
export interface SaveNoteResp {
|
|
184
|
-
id:
|
|
192
|
+
id: string;
|
|
185
193
|
title: string;
|
|
186
194
|
created_at: string;
|
|
187
195
|
updated_at: string;
|
|
@@ -203,7 +211,7 @@ export interface NoteTaskProgress {
|
|
|
203
211
|
/** 任务状态:pending / processing / success / failed */
|
|
204
212
|
status: "pending" | "processing" | "success" | "failed";
|
|
205
213
|
/** 笔记 ID(status 为 success 时返回) */
|
|
206
|
-
note_id?:
|
|
214
|
+
note_id?: string;
|
|
207
215
|
/** 错误信息(status 为 failed 时返回) */
|
|
208
216
|
error_msg?: string;
|
|
209
217
|
/** 任务创建时间 */
|
|
@@ -212,14 +220,14 @@ export interface NoteTaskProgress {
|
|
|
212
220
|
update_time: string;
|
|
213
221
|
}
|
|
214
222
|
export interface DeleteNoteResp {
|
|
215
|
-
note_id:
|
|
223
|
+
note_id: string;
|
|
216
224
|
}
|
|
217
225
|
export interface AddNoteTagsResp {
|
|
218
|
-
note_id:
|
|
226
|
+
note_id: string;
|
|
219
227
|
tags: TagInfo[];
|
|
220
228
|
}
|
|
221
229
|
export interface DeleteNoteTagResp {
|
|
222
|
-
note_id:
|
|
230
|
+
note_id: string;
|
|
223
231
|
tags: TagInfo[];
|
|
224
232
|
}
|
|
225
233
|
export interface GetUploadConfigResp {
|
|
@@ -239,14 +247,21 @@ export interface ImageUploadToken {
|
|
|
239
247
|
oss_content_type: string;
|
|
240
248
|
}
|
|
241
249
|
export type GetUploadTokenResp = ImageUploadToken;
|
|
250
|
+
export interface KnowledgeTopicStats {
|
|
251
|
+
note_count: number;
|
|
252
|
+
file_count: number;
|
|
253
|
+
blogger_count: number;
|
|
254
|
+
live_count: number;
|
|
255
|
+
}
|
|
242
256
|
export interface KnowledgeTopic {
|
|
243
257
|
id: string;
|
|
244
258
|
name: string;
|
|
245
259
|
description?: string;
|
|
246
260
|
cover?: string;
|
|
247
261
|
scope?: string;
|
|
248
|
-
|
|
249
|
-
|
|
262
|
+
stats?: KnowledgeTopicStats;
|
|
263
|
+
created_at?: string;
|
|
264
|
+
updated_at?: string;
|
|
250
265
|
}
|
|
251
266
|
export interface ListTopicsResp {
|
|
252
267
|
topics: KnowledgeTopic[];
|
|
@@ -261,7 +276,7 @@ export interface CreateTopicResp {
|
|
|
261
276
|
scope?: string;
|
|
262
277
|
}
|
|
263
278
|
export interface TopicNoteItem {
|
|
264
|
-
note_id:
|
|
279
|
+
note_id: string;
|
|
265
280
|
title: string;
|
|
266
281
|
content: string;
|
|
267
282
|
note_type: string;
|
|
@@ -388,7 +403,7 @@ export interface UpdateNoteReq {
|
|
|
388
403
|
tags?: string[];
|
|
389
404
|
}
|
|
390
405
|
export interface UpdateNoteResp {
|
|
391
|
-
note_id:
|
|
406
|
+
note_id: string;
|
|
392
407
|
title: string;
|
|
393
408
|
updated_at: string;
|
|
394
409
|
}
|
package/dist/client.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
package/dist/client.js
CHANGED
|
@@ -39,6 +39,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
39
39
|
exports.GetNoteClient = exports.GetNoteAPIError = void 0;
|
|
40
40
|
const axios_1 = __importDefault(require("axios"));
|
|
41
41
|
const BASE_URL = "https://openapi.biji.com/open/api/v1";
|
|
42
|
+
/**
|
|
43
|
+
* Preserves long-integer ID fields as JSON strings before JSON.parse, so JS
|
|
44
|
+
* doesn't silently round-trip them through `number` (which loses precision
|
|
45
|
+
* beyond 2^53 ≈ 9e15). Get笔记 note IDs are snowflake-like (≈ 1.9e18) and
|
|
46
|
+
* exceed this limit, so without this hook `note_id` / `next_cursor` come
|
|
47
|
+
* back corrupted and cursor pagination silently loops on the same page.
|
|
48
|
+
*
|
|
49
|
+
* Matches only when the captured field value has 16+ digits, so short IDs
|
|
50
|
+
* remain numbers.
|
|
51
|
+
*/
|
|
52
|
+
function parseJsonPreservingLargeIntegerStrings(data) {
|
|
53
|
+
if (typeof data !== "string" || data.trim() === "")
|
|
54
|
+
return data;
|
|
55
|
+
const safe = data.replace(/"(note_id|next_cursor|id|parent_id|topic_id|since_id|share_id)"\s*:\s*(\d{16,})/g, '"$1":"$2"');
|
|
56
|
+
return JSON.parse(safe);
|
|
57
|
+
}
|
|
42
58
|
class GetNoteAPIError extends Error {
|
|
43
59
|
code;
|
|
44
60
|
reason;
|
|
@@ -64,6 +80,7 @@ class GetNoteClient {
|
|
|
64
80
|
},
|
|
65
81
|
timeout: 30000,
|
|
66
82
|
});
|
|
83
|
+
this.http.defaults.transformResponse = [parseJsonPreservingLargeIntegerStrings];
|
|
67
84
|
this.http.interceptors.response.use((res) => res, (err) => {
|
|
68
85
|
throw err;
|
|
69
86
|
});
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@getnote/mcp",
|
|
3
|
-
"version": "1.
|
|
4
|
-
"description": "MCP server for Get
|
|
3
|
+
"version": "1.4.0",
|
|
4
|
+
"description": "MCP server for Get\u7b14\u8bb0 (GetNotes) API",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"bin": {
|
|
7
7
|
"getnote-mcp": "dist/index.js"
|
|
@@ -15,11 +15,11 @@
|
|
|
15
15
|
"keywords": [
|
|
16
16
|
"mcp",
|
|
17
17
|
"getnotes",
|
|
18
|
-
"get
|
|
18
|
+
"get\u7b14\u8bb0",
|
|
19
19
|
"notes",
|
|
20
20
|
"ai"
|
|
21
21
|
],
|
|
22
|
-
"author": "Get
|
|
22
|
+
"author": "Get\u7b14\u8bb0",
|
|
23
23
|
"license": "MIT",
|
|
24
24
|
"dependencies": {
|
|
25
25
|
"@modelcontextprotocol/sdk": "^1.0.0",
|
package/src/client.ts
CHANGED
|
@@ -2,6 +2,25 @@ import axios, { AxiosInstance, AxiosError } from "axios";
|
|
|
2
2
|
|
|
3
3
|
const BASE_URL = "https://openapi.biji.com/open/api/v1";
|
|
4
4
|
|
|
5
|
+
/**
|
|
6
|
+
* Preserves long-integer ID fields as JSON strings before JSON.parse, so JS
|
|
7
|
+
* doesn't silently round-trip them through `number` (which loses precision
|
|
8
|
+
* beyond 2^53 ≈ 9e15). Get笔记 note IDs are snowflake-like (≈ 1.9e18) and
|
|
9
|
+
* exceed this limit, so without this hook `note_id` / `next_cursor` come
|
|
10
|
+
* back corrupted and cursor pagination silently loops on the same page.
|
|
11
|
+
*
|
|
12
|
+
* Matches only when the captured field value has 16+ digits, so short IDs
|
|
13
|
+
* remain numbers.
|
|
14
|
+
*/
|
|
15
|
+
function parseJsonPreservingLargeIntegerStrings(data: unknown) {
|
|
16
|
+
if (typeof data !== "string" || data.trim() === "") return data;
|
|
17
|
+
const safe = data.replace(
|
|
18
|
+
/"(note_id|next_cursor|id|parent_id|topic_id|since_id|share_id)"\s*:\s*(\d{16,})/g,
|
|
19
|
+
'"$1":"$2"'
|
|
20
|
+
);
|
|
21
|
+
return JSON.parse(safe);
|
|
22
|
+
}
|
|
23
|
+
|
|
5
24
|
export class GetNoteAPIError extends Error {
|
|
6
25
|
constructor(
|
|
7
26
|
public readonly code: number,
|
|
@@ -27,6 +46,7 @@ export class GetNoteClient {
|
|
|
27
46
|
},
|
|
28
47
|
timeout: 30000,
|
|
29
48
|
});
|
|
49
|
+
this.http.defaults.transformResponse = [parseJsonPreservingLargeIntegerStrings];
|
|
30
50
|
|
|
31
51
|
this.http.interceptors.response.use(
|
|
32
52
|
(res) => res,
|
|
@@ -371,14 +391,18 @@ export interface TagInfo {
|
|
|
371
391
|
}
|
|
372
392
|
|
|
373
393
|
export interface NoteItem {
|
|
374
|
-
|
|
394
|
+
/**
|
|
395
|
+
* Note ID. Returned as string because the actual values exceed
|
|
396
|
+
* Number.MAX_SAFE_INTEGER. See parseJsonPreservingLargeIntegerStrings.
|
|
397
|
+
*/
|
|
398
|
+
id: string;
|
|
375
399
|
title: string;
|
|
376
400
|
content: string;
|
|
377
401
|
ref_content?: string;
|
|
378
402
|
note_type: string;
|
|
379
403
|
source: string;
|
|
380
404
|
tags: TagInfo[];
|
|
381
|
-
parent_id?:
|
|
405
|
+
parent_id?: string;
|
|
382
406
|
children_count?: number;
|
|
383
407
|
topics?: { id: string; name: string }[];
|
|
384
408
|
is_child_note?: boolean;
|
|
@@ -415,7 +439,11 @@ export interface NoteDetail extends NoteItem {
|
|
|
415
439
|
export interface ListNotesResp {
|
|
416
440
|
notes: NoteItem[];
|
|
417
441
|
has_more: boolean;
|
|
418
|
-
|
|
442
|
+
/**
|
|
443
|
+
* Cursor for the next page. Pass it back as `since_id` on the next call.
|
|
444
|
+
* Returned as string because IDs exceed Number.MAX_SAFE_INTEGER.
|
|
445
|
+
*/
|
|
446
|
+
next_cursor?: string;
|
|
419
447
|
total: number;
|
|
420
448
|
}
|
|
421
449
|
|
|
@@ -442,7 +470,7 @@ export interface NoteTaskItem {
|
|
|
442
470
|
}
|
|
443
471
|
|
|
444
472
|
export interface SaveNoteResp {
|
|
445
|
-
id:
|
|
473
|
+
id: string;
|
|
446
474
|
title: string;
|
|
447
475
|
created_at: string;
|
|
448
476
|
updated_at: string;
|
|
@@ -465,7 +493,7 @@ export interface NoteTaskProgress {
|
|
|
465
493
|
/** 任务状态:pending / processing / success / failed */
|
|
466
494
|
status: "pending" | "processing" | "success" | "failed";
|
|
467
495
|
/** 笔记 ID(status 为 success 时返回) */
|
|
468
|
-
note_id?:
|
|
496
|
+
note_id?: string;
|
|
469
497
|
/** 错误信息(status 为 failed 时返回) */
|
|
470
498
|
error_msg?: string;
|
|
471
499
|
/** 任务创建时间 */
|
|
@@ -475,16 +503,16 @@ export interface NoteTaskProgress {
|
|
|
475
503
|
}
|
|
476
504
|
|
|
477
505
|
export interface DeleteNoteResp {
|
|
478
|
-
note_id:
|
|
506
|
+
note_id: string;
|
|
479
507
|
}
|
|
480
508
|
|
|
481
509
|
export interface AddNoteTagsResp {
|
|
482
|
-
note_id:
|
|
510
|
+
note_id: string;
|
|
483
511
|
tags: TagInfo[];
|
|
484
512
|
}
|
|
485
513
|
|
|
486
514
|
export interface DeleteNoteTagResp {
|
|
487
|
-
note_id:
|
|
515
|
+
note_id: string;
|
|
488
516
|
tags: TagInfo[];
|
|
489
517
|
}
|
|
490
518
|
|
|
@@ -510,14 +538,22 @@ export interface ImageUploadToken {
|
|
|
510
538
|
// 直接返回单个 token
|
|
511
539
|
export type GetUploadTokenResp = ImageUploadToken;
|
|
512
540
|
|
|
541
|
+
export interface KnowledgeTopicStats {
|
|
542
|
+
note_count: number;
|
|
543
|
+
file_count: number;
|
|
544
|
+
blogger_count: number;
|
|
545
|
+
live_count: number;
|
|
546
|
+
}
|
|
547
|
+
|
|
513
548
|
export interface KnowledgeTopic {
|
|
514
549
|
id: string;
|
|
515
550
|
name: string;
|
|
516
551
|
description?: string;
|
|
517
552
|
cover?: string;
|
|
518
553
|
scope?: string;
|
|
519
|
-
|
|
520
|
-
|
|
554
|
+
stats?: KnowledgeTopicStats;
|
|
555
|
+
created_at?: string;
|
|
556
|
+
updated_at?: string;
|
|
521
557
|
}
|
|
522
558
|
|
|
523
559
|
export interface ListTopicsResp {
|
|
@@ -535,7 +571,7 @@ export interface CreateTopicResp {
|
|
|
535
571
|
}
|
|
536
572
|
|
|
537
573
|
export interface TopicNoteItem {
|
|
538
|
-
note_id:
|
|
574
|
+
note_id: string;
|
|
539
575
|
title: string;
|
|
540
576
|
content: string;
|
|
541
577
|
note_type: string;
|
|
@@ -693,7 +729,7 @@ export interface UpdateNoteReq {
|
|
|
693
729
|
}
|
|
694
730
|
|
|
695
731
|
export interface UpdateNoteResp {
|
|
696
|
-
note_id:
|
|
732
|
+
note_id: string;
|
|
697
733
|
title: string;
|
|
698
734
|
updated_at: string;
|
|
699
735
|
}
|