@getnote/mcp 1.10.0 → 1.10.1

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
@@ -153,6 +153,18 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
153
153
 
154
154
  > **语音笔记等其他类型**只能在 得到大脑(Get笔记) App 或 Web 端创建,MCP 可以读取但无法创建。
155
155
 
156
+ ## 录音台与录音卡笔记
157
+
158
+ 使用 `list_notes` 的 `source` 定向筛选:AI录音台/墨案MOAN录音台为 `vendor_moan`,GetSeed录音卡为 `getseed`。设备全部笔记只限定来源,不额外加 `note_type=audio/meeting`;录音卡长录音和闪念均包含。明确只要其中一种录音卡模式时,才叠加 `recorder_audio` 或 `recorder_flash_audio`。
159
+
160
+ ```json
161
+ {"name":"list_notes","arguments":{"source":"vendor_moan","page_size":20}}
162
+ ```
163
+
164
+ 昨天/上周的笔记叠加 created_from/created_to(用户时区的RFC3339边界,from包含、to不包含)。翻页保留全部原条件,核对 applied_filters.source 与 notes[].source,按 pagination.next_cursor 继续并去重。has_more=false且无未解决的partial/warnings才表示当前授权范围已遍历;旧total不是设备范围总数。空结果不换来源补数,不能用标签或标题猜设备来源;没有设备约束的普通录音查询不加设备source。
165
+
166
+ 只覆盖已经同步成笔记且有权读取的主笔记,不包括设备未同步或尚未形成笔记的会议记录。设备范围内的正文主题先按来源列候选、按需读正文,不把全局recall的Top-K后过滤称为完整设备搜索。转写用 `get_note_transcript`,不把AI总结/preview当作转写,也不把转写缺失当作笔记不存在。
167
+
156
168
  ## 查找笔记与书库
157
169
 
158
170
  - 书名用 `list_topics` 的 `query`,作者用 `author`,并指定 `scope: "BOOKSPACE"`。两者同时传入时须同时匹配;订阅书库使用 `list_subscribe_topics`。
package/dist/index.js CHANGED
@@ -133,7 +133,7 @@ function snowflakeID(value, field) {
133
133
  // ─── Tool Definitions ────────────────────────────────────────────────────────
134
134
  const noteDiscoveryProperties = {
135
135
  page: { type: "integer", minimum: 1, description: "知识库内可用页码;与 cursor 互斥" },
136
- source: { type: "string", description: "来源平台精确筛选,如 dedao" },
136
+ source: { type: "string", description: "笔记真实来源精确筛选:vendor_moan=AI录音台/墨案MOAN录音台,getseed=GetSeed录音卡(长录音与闪念),dedao=得到。查设备全部笔记只加来源,不额外限定audio/meeting;未限定设备时不加设备来源。" },
137
137
  note_type: { type: "string", description: "真实类型精确筛选:ref=引用划线,audio=即时/普通录音,local_audio=上传音频文件,class_audio=自己录制的课堂笔记,meeting=会议,internal_record=内录,recorder_audio/recorder_flash_audio=录音卡长录音/闪念。录音不默认限定dedao或课程。" },
138
138
  reference_resource_type: { type: "string", description: "引用资源类型,如 ebook、course_article、audio_book" },
139
139
  reference_resource_id: { type: "string", description: "引用资源 ID,必须字符串;同时传 source 和 reference_resource_type" },
@@ -175,7 +175,7 @@ const TOOLS = [
175
175
  ...noteDiscoveryProperties,
176
176
  cursor: {
177
177
  type: "string",
178
- description: "翻页游标。首次不传;后续将上一次响应的 cursor 字段原样传入即可,无需任何转换。",
178
+ description: "首次省略。来源/类型/时间等新筛选使用pagination.next_cursor,保持原条件和page_size,直到has_more=false;仅旧默认列表沿旧响应cursor继续。不转换、不复用其他来源游标。",
179
179
  },
180
180
  },
181
181
  required: [],
@@ -207,7 +207,7 @@ const TOOLS = [
207
207
  },
208
208
  {
209
209
  name: "get_note_transcript",
210
- description: "直接读取录音、会议或课堂笔记的转写原文;没有转写时明确返回不可用。",
210
+ description: "直接读取录音台、录音卡及录音、会议或课堂笔记的转写原文;设备来源先用list_notes.source定位。没有转写时明确返回不可用,不用AI总结代替。",
211
211
  inputSchema: { type: "object", properties: { id: { type: ["string", "number"], description: "笔记 ID,推荐十进制字符串" } }, required: ["id"] },
212
212
  },
213
213
  {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@getnote/mcp",
3
- "version": "1.10.0",
3
+ "version": "1.10.1",
4
4
  "description": "MCP server for 得到大脑(Get笔记) — manage notes and knowledge bases from AI assistants",
5
5
  "main": "dist/index.js",
6
6
  "bin": {
package/src/index.ts CHANGED
@@ -123,7 +123,7 @@ function snowflakeID(value: unknown, field: string): string | number {
123
123
 
124
124
  const noteDiscoveryProperties = {
125
125
  page: { type: "integer", minimum: 1, description: "知识库内可用页码;与 cursor 互斥" },
126
- source: { type: "string", description: "来源平台精确筛选,如 dedao" },
126
+ source: { type: "string", description: "笔记真实来源精确筛选:vendor_moan=AI录音台/墨案MOAN录音台,getseed=GetSeed录音卡(长录音与闪念),dedao=得到。查设备全部笔记只加来源,不额外限定audio/meeting;未限定设备时不加设备来源。" },
127
127
  note_type: { type: "string", description: "真实类型精确筛选:ref=引用划线,audio=即时/普通录音,local_audio=上传音频文件,class_audio=自己录制的课堂笔记,meeting=会议,internal_record=内录,recorder_audio/recorder_flash_audio=录音卡长录音/闪念。录音不默认限定dedao或课程。" },
128
128
  reference_resource_type: { type: "string", description: "引用资源类型,如 ebook、course_article、audio_book" },
129
129
  reference_resource_id: { type: "string", description: "引用资源 ID,必须字符串;同时传 source 和 reference_resource_type" },
@@ -167,7 +167,7 @@ const TOOLS: Tool[] = [
167
167
  ...noteDiscoveryProperties,
168
168
  cursor: {
169
169
  type: "string",
170
- description: "翻页游标。首次不传;后续将上一次响应的 cursor 字段原样传入即可,无需任何转换。",
170
+ description: "首次省略。来源/类型/时间等新筛选使用pagination.next_cursor,保持原条件和page_size,直到has_more=false;仅旧默认列表沿旧响应cursor继续。不转换、不复用其他来源游标。",
171
171
  },
172
172
  },
173
173
  required: [],
@@ -199,7 +199,7 @@ const TOOLS: Tool[] = [
199
199
  },
200
200
  {
201
201
  name: "get_note_transcript",
202
- description: "直接读取录音、会议或课堂笔记的转写原文;没有转写时明确返回不可用。",
202
+ description: "直接读取录音台、录音卡及录音、会议或课堂笔记的转写原文;设备来源先用list_notes.source定位。没有转写时明确返回不可用,不用AI总结代替。",
203
203
  inputSchema: { type: "object" as const, properties: { id: { type: ["string", "number"], description: "笔记 ID,推荐十进制字符串" } }, required: ["id"] },
204
204
  },
205
205
  {