yuque-ai-mcp 2.7.4

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.
Files changed (316) hide show
  1. package/dist/board/create-board.d.ts +7 -0
  2. package/dist/board/create-board.js +50 -0
  3. package/dist/board/create-board.js.map +1 -0
  4. package/dist/board/get-board.d.ts +7 -0
  5. package/dist/board/get-board.js +44 -0
  6. package/dist/board/get-board.js.map +1 -0
  7. package/dist/board/index.d.ts +5 -0
  8. package/dist/board/index.js +8 -0
  9. package/dist/board/index.js.map +1 -0
  10. package/dist/board/update-board.d.ts +7 -0
  11. package/dist/board/update-board.js +65 -0
  12. package/dist/board/update-board.js.map +1 -0
  13. package/dist/cli-http.d.ts +2 -0
  14. package/dist/cli-http.js +16 -0
  15. package/dist/cli-http.js.map +1 -0
  16. package/dist/cli.d.ts +2 -0
  17. package/dist/cli.js +15 -0
  18. package/dist/cli.js.map +1 -0
  19. package/dist/common/api-client.d.ts +27 -0
  20. package/dist/common/api-client.js +198 -0
  21. package/dist/common/api-client.js.map +1 -0
  22. package/dist/common/config.d.ts +46 -0
  23. package/dist/common/config.js +86 -0
  24. package/dist/common/config.js.map +1 -0
  25. package/dist/common/copy-common.d.ts +8 -0
  26. package/dist/common/copy-common.js +13 -0
  27. package/dist/common/copy-common.js.map +1 -0
  28. package/dist/common/errors.d.ts +44 -0
  29. package/dist/common/errors.js +164 -0
  30. package/dist/common/errors.js.map +1 -0
  31. package/dist/common/export-common.d.ts +32 -0
  32. package/dist/common/export-common.js +125 -0
  33. package/dist/common/export-common.js.map +1 -0
  34. package/dist/common/format.d.ts +247 -0
  35. package/dist/common/format.js +199 -0
  36. package/dist/common/format.js.map +1 -0
  37. package/dist/common/register-tools.d.ts +29 -0
  38. package/dist/common/register-tools.js +89 -0
  39. package/dist/common/register-tools.js.map +1 -0
  40. package/dist/common/repo-capacity.d.ts +26 -0
  41. package/dist/common/repo-capacity.js +105 -0
  42. package/dist/common/repo-capacity.js.map +1 -0
  43. package/dist/common/schedule-common.d.ts +38 -0
  44. package/dist/common/schedule-common.js +111 -0
  45. package/dist/common/schedule-common.js.map +1 -0
  46. package/dist/common/text-utils.d.ts +11 -0
  47. package/dist/common/text-utils.js +29 -0
  48. package/dist/common/text-utils.js.map +1 -0
  49. package/dist/common/toc-cache.d.ts +30 -0
  50. package/dist/common/toc-cache.js +109 -0
  51. package/dist/common/toc-cache.js.map +1 -0
  52. package/dist/common/types.d.ts +17 -0
  53. package/dist/common/types.js +3 -0
  54. package/dist/common/types.js.map +1 -0
  55. package/dist/common/validate.d.ts +27 -0
  56. package/dist/common/validate.js +70 -0
  57. package/dist/common/validate.js.map +1 -0
  58. package/dist/common/web-request.d.ts +13 -0
  59. package/dist/common/web-request.js +53 -0
  60. package/dist/common/web-request.js.map +1 -0
  61. package/dist/crawler/extract.d.ts +19 -0
  62. package/dist/crawler/extract.js +220 -0
  63. package/dist/crawler/extract.js.map +1 -0
  64. package/dist/crawler/fetch.d.ts +8 -0
  65. package/dist/crawler/fetch.js +89 -0
  66. package/dist/crawler/fetch.js.map +1 -0
  67. package/dist/crawler/index.d.ts +6 -0
  68. package/dist/crawler/index.js +10 -0
  69. package/dist/crawler/index.js.map +1 -0
  70. package/dist/crawler/save.d.ts +11 -0
  71. package/dist/crawler/save.js +160 -0
  72. package/dist/crawler/save.js.map +1 -0
  73. package/dist/crawler/schedule.d.ts +12 -0
  74. package/dist/crawler/schedule.js +132 -0
  75. package/dist/crawler/schedule.js.map +1 -0
  76. package/dist/doc/batch-get-docs.d.ts +8 -0
  77. package/dist/doc/batch-get-docs.js +100 -0
  78. package/dist/doc/batch-get-docs.js.map +1 -0
  79. package/dist/doc/copy-doc.d.ts +10 -0
  80. package/dist/doc/copy-doc.js +238 -0
  81. package/dist/doc/copy-doc.js.map +1 -0
  82. package/dist/doc/create-doc.d.ts +11 -0
  83. package/dist/doc/create-doc.js +82 -0
  84. package/dist/doc/create-doc.js.map +1 -0
  85. package/dist/doc/delete-doc.d.ts +8 -0
  86. package/dist/doc/delete-doc.js +39 -0
  87. package/dist/doc/delete-doc.js.map +1 -0
  88. package/dist/doc/diff-doc.d.ts +8 -0
  89. package/dist/doc/diff-doc.js +190 -0
  90. package/dist/doc/diff-doc.js.map +1 -0
  91. package/dist/doc/embed-url.d.ts +10 -0
  92. package/dist/doc/embed-url.js +137 -0
  93. package/dist/doc/embed-url.js.map +1 -0
  94. package/dist/doc/export-doc.d.ts +10 -0
  95. package/dist/doc/export-doc.js +135 -0
  96. package/dist/doc/export-doc.js.map +1 -0
  97. package/dist/doc/get-doc.d.ts +8 -0
  98. package/dist/doc/get-doc.js +40 -0
  99. package/dist/doc/get-doc.js.map +1 -0
  100. package/dist/doc/import-file-utils.d.ts +37 -0
  101. package/dist/doc/import-file-utils.js +256 -0
  102. package/dist/doc/import-file-utils.js.map +1 -0
  103. package/dist/doc/import-file.d.ts +13 -0
  104. package/dist/doc/import-file.js +333 -0
  105. package/dist/doc/import-file.js.map +1 -0
  106. package/dist/doc/import-url.d.ts +7 -0
  107. package/dist/doc/import-url.js +245 -0
  108. package/dist/doc/import-url.js.map +1 -0
  109. package/dist/doc/index.d.ts +16 -0
  110. package/dist/doc/index.js +30 -0
  111. package/dist/doc/index.js.map +1 -0
  112. package/dist/doc/list-docs.d.ts +8 -0
  113. package/dist/doc/list-docs.js +44 -0
  114. package/dist/doc/list-docs.js.map +1 -0
  115. package/dist/doc/update-doc.d.ts +8 -0
  116. package/dist/doc/update-doc.js +50 -0
  117. package/dist/doc/update-doc.js.map +1 -0
  118. package/dist/doc/version-detail.d.ts +8 -0
  119. package/dist/doc/version-detail.js +34 -0
  120. package/dist/doc/version-detail.js.map +1 -0
  121. package/dist/doc/versions.d.ts +8 -0
  122. package/dist/doc/versions.js +34 -0
  123. package/dist/doc/versions.js.map +1 -0
  124. package/dist/group/delete-user.d.ts +8 -0
  125. package/dist/group/delete-user.js +39 -0
  126. package/dist/group/delete-user.js.map +1 -0
  127. package/dist/group/index.d.ts +5 -0
  128. package/dist/group/index.js +8 -0
  129. package/dist/group/index.js.map +1 -0
  130. package/dist/group/list-users.d.ts +8 -0
  131. package/dist/group/list-users.js +40 -0
  132. package/dist/group/list-users.js.map +1 -0
  133. package/dist/group/update-user.d.ts +8 -0
  134. package/dist/group/update-user.js +37 -0
  135. package/dist/group/update-user.js.map +1 -0
  136. package/dist/http.d.ts +1 -0
  137. package/dist/http.js +114 -0
  138. package/dist/http.js.map +1 -0
  139. package/dist/index.d.ts +1 -0
  140. package/dist/index.js +27 -0
  141. package/dist/index.js.map +1 -0
  142. package/dist/kv/common.d.ts +34 -0
  143. package/dist/kv/common.js +191 -0
  144. package/dist/kv/common.js.map +1 -0
  145. package/dist/kv/delete.d.ts +7 -0
  146. package/dist/kv/delete.js +52 -0
  147. package/dist/kv/delete.js.map +1 -0
  148. package/dist/kv/get.d.ts +7 -0
  149. package/dist/kv/get.js +52 -0
  150. package/dist/kv/get.js.map +1 -0
  151. package/dist/kv/index.d.ts +6 -0
  152. package/dist/kv/index.js +10 -0
  153. package/dist/kv/index.js.map +1 -0
  154. package/dist/kv/list.d.ts +5 -0
  155. package/dist/kv/list.js +42 -0
  156. package/dist/kv/list.js.map +1 -0
  157. package/dist/kv/set.d.ts +7 -0
  158. package/dist/kv/set.js +54 -0
  159. package/dist/kv/set.js.map +1 -0
  160. package/dist/mine/common.d.ts +4 -0
  161. package/dist/mine/common.js +5 -0
  162. package/dist/mine/common.js.map +1 -0
  163. package/dist/mine/editor-center.d.ts +9 -0
  164. package/dist/mine/editor-center.js +57 -0
  165. package/dist/mine/editor-center.js.map +1 -0
  166. package/dist/mine/get-book-stacks.d.ts +8 -0
  167. package/dist/mine/get-book-stacks.js +41 -0
  168. package/dist/mine/get-book-stacks.js.map +1 -0
  169. package/dist/mine/index.d.ts +4 -0
  170. package/dist/mine/index.js +6 -0
  171. package/dist/mine/index.js.map +1 -0
  172. package/dist/note/create-note.d.ts +8 -0
  173. package/dist/note/create-note.js +32 -0
  174. package/dist/note/create-note.js.map +1 -0
  175. package/dist/note/get-note.d.ts +8 -0
  176. package/dist/note/get-note.js +27 -0
  177. package/dist/note/get-note.js.map +1 -0
  178. package/dist/note/index.d.ts +6 -0
  179. package/dist/note/index.js +10 -0
  180. package/dist/note/index.js.map +1 -0
  181. package/dist/note/list-notes.d.ts +8 -0
  182. package/dist/note/list-notes.js +40 -0
  183. package/dist/note/list-notes.js.map +1 -0
  184. package/dist/note/update-note.d.ts +8 -0
  185. package/dist/note/update-note.js +53 -0
  186. package/dist/note/update-note.js.map +1 -0
  187. package/dist/recycle/common.d.ts +4 -0
  188. package/dist/recycle/common.js +5 -0
  189. package/dist/recycle/common.js.map +1 -0
  190. package/dist/recycle/destroy-recycle.d.ts +8 -0
  191. package/dist/recycle/destroy-recycle.js +38 -0
  192. package/dist/recycle/destroy-recycle.js.map +1 -0
  193. package/dist/recycle/index.d.ts +5 -0
  194. package/dist/recycle/index.js +8 -0
  195. package/dist/recycle/index.js.map +1 -0
  196. package/dist/recycle/list-recycles.d.ts +8 -0
  197. package/dist/recycle/list-recycles.js +57 -0
  198. package/dist/recycle/list-recycles.js.map +1 -0
  199. package/dist/recycle/restore-recycle.d.ts +7 -0
  200. package/dist/recycle/restore-recycle.js +32 -0
  201. package/dist/recycle/restore-recycle.js.map +1 -0
  202. package/dist/repo/batch-get-repos.d.ts +8 -0
  203. package/dist/repo/batch-get-repos.js +83 -0
  204. package/dist/repo/batch-get-repos.js.map +1 -0
  205. package/dist/repo/copy-repo.d.ts +7 -0
  206. package/dist/repo/copy-repo.js +137 -0
  207. package/dist/repo/copy-repo.js.map +1 -0
  208. package/dist/repo/create-repo.d.ts +8 -0
  209. package/dist/repo/create-repo.js +49 -0
  210. package/dist/repo/create-repo.js.map +1 -0
  211. package/dist/repo/delete-repo.d.ts +8 -0
  212. package/dist/repo/delete-repo.js +37 -0
  213. package/dist/repo/delete-repo.js.map +1 -0
  214. package/dist/repo/export-graph.d.ts +21 -0
  215. package/dist/repo/export-graph.js +73 -0
  216. package/dist/repo/export-graph.js.map +1 -0
  217. package/dist/repo/export-index.d.ts +26 -0
  218. package/dist/repo/export-index.js +72 -0
  219. package/dist/repo/export-index.js.map +1 -0
  220. package/dist/repo/export-repo.d.ts +14 -0
  221. package/dist/repo/export-repo.js +243 -0
  222. package/dist/repo/export-repo.js.map +1 -0
  223. package/dist/repo/export-toc.d.ts +17 -0
  224. package/dist/repo/export-toc.js +33 -0
  225. package/dist/repo/export-toc.js.map +1 -0
  226. package/dist/repo/get-repo.d.ts +8 -0
  227. package/dist/repo/get-repo.js +32 -0
  228. package/dist/repo/get-repo.js.map +1 -0
  229. package/dist/repo/index.d.ts +10 -0
  230. package/dist/repo/index.js +18 -0
  231. package/dist/repo/index.js.map +1 -0
  232. package/dist/repo/list-repos.d.ts +8 -0
  233. package/dist/repo/list-repos.js +48 -0
  234. package/dist/repo/list-repos.js.map +1 -0
  235. package/dist/repo/update-repo.d.ts +8 -0
  236. package/dist/repo/update-repo.js +48 -0
  237. package/dist/repo/update-repo.js.map +1 -0
  238. package/dist/rss/dedup.d.ts +9 -0
  239. package/dist/rss/dedup.js +21 -0
  240. package/dist/rss/dedup.js.map +1 -0
  241. package/dist/rss/fetch-feed.d.ts +8 -0
  242. package/dist/rss/fetch-feed.js +290 -0
  243. package/dist/rss/fetch-feed.js.map +1 -0
  244. package/dist/rss/index.d.ts +5 -0
  245. package/dist/rss/index.js +8 -0
  246. package/dist/rss/index.js.map +1 -0
  247. package/dist/rss/list-sources.d.ts +8 -0
  248. package/dist/rss/list-sources.js +39 -0
  249. package/dist/rss/list-sources.js.map +1 -0
  250. package/dist/rss/parser.d.ts +27 -0
  251. package/dist/rss/parser.js +87 -0
  252. package/dist/rss/parser.js.map +1 -0
  253. package/dist/rss/schedule.d.ts +14 -0
  254. package/dist/rss/schedule.js +171 -0
  255. package/dist/rss/schedule.js.map +1 -0
  256. package/dist/rss/sources.d.ts +26 -0
  257. package/dist/rss/sources.js +54 -0
  258. package/dist/rss/sources.js.map +1 -0
  259. package/dist/search/index.d.ts +4 -0
  260. package/dist/search/index.js +6 -0
  261. package/dist/search/index.js.map +1 -0
  262. package/dist/search/rag-search-utils.d.ts +28 -0
  263. package/dist/search/rag-search-utils.js +74 -0
  264. package/dist/search/rag-search-utils.js.map +1 -0
  265. package/dist/search/rag-search.d.ts +16 -0
  266. package/dist/search/rag-search.js +103 -0
  267. package/dist/search/rag-search.js.map +1 -0
  268. package/dist/search/search.d.ts +8 -0
  269. package/dist/search/search.js +43 -0
  270. package/dist/search/search.js.map +1 -0
  271. package/dist/statistic/book-statistics.d.ts +7 -0
  272. package/dist/statistic/book-statistics.js +49 -0
  273. package/dist/statistic/book-statistics.js.map +1 -0
  274. package/dist/statistic/doc-statistics.d.ts +7 -0
  275. package/dist/statistic/doc-statistics.js +53 -0
  276. package/dist/statistic/doc-statistics.js.map +1 -0
  277. package/dist/statistic/group-statistics.d.ts +8 -0
  278. package/dist/statistic/group-statistics.js +30 -0
  279. package/dist/statistic/group-statistics.js.map +1 -0
  280. package/dist/statistic/index.d.ts +6 -0
  281. package/dist/statistic/index.js +10 -0
  282. package/dist/statistic/index.js.map +1 -0
  283. package/dist/statistic/member-statistics.d.ts +7 -0
  284. package/dist/statistic/member-statistics.js +49 -0
  285. package/dist/statistic/member-statistics.js.map +1 -0
  286. package/dist/toc/batch-update.d.ts +11 -0
  287. package/dist/toc/batch-update.js +274 -0
  288. package/dist/toc/batch-update.js.map +1 -0
  289. package/dist/toc/get-toc.d.ts +8 -0
  290. package/dist/toc/get-toc.js +33 -0
  291. package/dist/toc/get-toc.js.map +1 -0
  292. package/dist/toc/index.d.ts +5 -0
  293. package/dist/toc/index.js +8 -0
  294. package/dist/toc/index.js.map +1 -0
  295. package/dist/toc/update-toc.d.ts +8 -0
  296. package/dist/toc/update-toc.js +74 -0
  297. package/dist/toc/update-toc.js.map +1 -0
  298. package/dist/upload/index.d.ts +3 -0
  299. package/dist/upload/index.js +4 -0
  300. package/dist/upload/index.js.map +1 -0
  301. package/dist/upload/upload-attachment.d.ts +11 -0
  302. package/dist/upload/upload-attachment.js +162 -0
  303. package/dist/upload/upload-attachment.js.map +1 -0
  304. package/dist/user/get-groups.d.ts +8 -0
  305. package/dist/user/get-groups.js +41 -0
  306. package/dist/user/get-groups.js.map +1 -0
  307. package/dist/user/get-user.d.ts +8 -0
  308. package/dist/user/get-user.js +24 -0
  309. package/dist/user/get-user.js.map +1 -0
  310. package/dist/user/hello.d.ts +8 -0
  311. package/dist/user/hello.js +17 -0
  312. package/dist/user/hello.js.map +1 -0
  313. package/dist/user/index.d.ts +5 -0
  314. package/dist/user/index.js +8 -0
  315. package/dist/user/index.js.map +1 -0
  316. package/package.json +49 -0
@@ -0,0 +1,41 @@
1
+ /**
2
+ * mine/book-stacks — 获取知识库分组(书架)列表
3
+ *
4
+ * 端点:GET /api/mine/book_stacks(Web API,Cookie 认证)
5
+ * 职责:返回当前用户的知识库分组(书架),含每个分组下的知识库列表
6
+ */
7
+ import { webRequest } from "../common/web-request.js";
8
+ import { MINE_BASE } from "./common.js";
9
+ export const mineBookStacks = {
10
+ name: "yuque_get_book_stacks",
11
+ description: "获取当前用户的知识库分组(书架)列表,含每个分组下的知识库。需要 cookie+ctoken 认证。GET /api/mine/book_stacks",
12
+ inputSchema: {
13
+ type: "object",
14
+ properties: {},
15
+ },
16
+ async handler() {
17
+ const data = (await webRequest(`${MINE_BASE}/book_stacks`));
18
+ const stacks = (data?.data || []).map((s) => ({
19
+ id: s.id,
20
+ name: s.name,
21
+ rank: s.rank,
22
+ books: (s.books || []).map((b) => ({
23
+ id: b.id,
24
+ type: b.type,
25
+ slug: b.slug,
26
+ name: b.name,
27
+ description: b.description || "",
28
+ items_count: b.items_count,
29
+ })),
30
+ }));
31
+ return {
32
+ content: [
33
+ {
34
+ type: "text",
35
+ text: JSON.stringify({ stacks }, null, 2),
36
+ },
37
+ ],
38
+ };
39
+ },
40
+ };
41
+ //# sourceMappingURL=get-book-stacks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-book-stacks.js","sourceRoot":"","sources":["../../src/mine/get-book-stacks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,6EAA6E;IAE1F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,GAAG,CAAC,MAAM,UAAU,CAAC,GAAG,SAAS,cAAc,CAAC,CAczD,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjC,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;gBAChC,WAAW,EAAE,CAAC,CAAC,WAAW;aAC3B,CAAC,CAAC;SACJ,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC1C;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}
@@ -0,0 +1,4 @@
1
+ export { mineBookStacks } from "./get-book-stacks.js";
2
+ export { mineEditorCenter } from "./editor-center.js";
3
+ import type { McpTool } from "../common/types.js";
4
+ export declare const mineTools: McpTool[];
@@ -0,0 +1,6 @@
1
+ export { mineBookStacks } from "./get-book-stacks.js";
2
+ export { mineEditorCenter } from "./editor-center.js";
3
+ import { mineBookStacks } from "./get-book-stacks.js";
4
+ import { mineEditorCenter } from "./editor-center.js";
5
+ export const mineTools = [mineBookStacks, mineEditorCenter];
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,CAAC,MAAM,SAAS,GAAc,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * note/create — 创建小记
3
+ *
4
+ * 端点:POST /api/v2/notes
5
+ * 职责:创建一条新小记
6
+ */
7
+ import type { McpTool } from "../common/types.js";
8
+ export declare const noteCreate: McpTool;
@@ -0,0 +1,32 @@
1
+ /**
2
+ * note/create — 创建小记
3
+ *
4
+ * 端点:POST /api/v2/notes
5
+ * 职责:创建一条新小记
6
+ */
7
+ import { apiPost } from "../common/api-client.js";
8
+ import { requiredString } from "../common/validate.js";
9
+ import { formatNote, handleApiCall } from "../common/format.js";
10
+ export const noteCreate = {
11
+ name: "yuque_create_note",
12
+ description: "Create a note (short memo). Returns id, slug, note_url. POST /notes. 详见 references/api/note_api.md",
13
+ inputSchema: {
14
+ type: "object",
15
+ properties: {
16
+ body: { type: "string", description: "Note body content (required, plain text or Markdown)" },
17
+ raw: { type: "boolean", description: "Return raw full JSON (default false, returns trimmed fields)" },
18
+ },
19
+ required: ["body"],
20
+ },
21
+ async handler(args) {
22
+ // @validate
23
+ const __v = requiredString(args?.body, "body");
24
+ if (__v)
25
+ return __v;
26
+ const raw = args?.raw;
27
+ const body = args?.body;
28
+ const data = await apiPost("/notes", { body }, "Create note");
29
+ return handleApiCall(data, formatNote, raw);
30
+ },
31
+ };
32
+ //# sourceMappingURL=create-note.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"create-note.js","sourceRoot":"","sources":["../../src/note/create-note.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAiB,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGhE,MAAM,CAAC,MAAM,UAAU,GAAY;IACjC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,oGAAoG;IAEjH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sDAAsD,EAAE;YAC7F,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8DAA8D,EAAE;SACtG;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,GAAG,GAAG,IAAI,EAAE,GAA0B,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,EAAE,IAAc,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,aAAa,CAAC,CAAC;QAC9D,OAAO,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * note/get — 获取小记详情
3
+ *
4
+ * 端点:GET /api/v2/notes/:id
5
+ * 职责:返回小记完整内容
6
+ */
7
+ import type { McpTool } from "../common/types.js";
8
+ export declare const noteGet: McpTool;
@@ -0,0 +1,27 @@
1
+ /**
2
+ * note/get — 获取小记详情
3
+ *
4
+ * 端点:GET /api/v2/notes/:id
5
+ * 职责:返回小记完整内容
6
+ */
7
+ import { apiGet } from "../common/api-client.js";
8
+ import { formatNote, handleApiCall } from "../common/format.js";
9
+ export const noteGet = {
10
+ name: "yuque_get_note",
11
+ description: "Get note detail. GET /notes/:id. 详见 references/api/note_api.md",
12
+ inputSchema: {
13
+ type: "object",
14
+ properties: {
15
+ note_id: { type: "number", description: "Note ID (required)" },
16
+ raw: { type: "boolean", description: "Return raw full JSON (default false, returns trimmed fields)" },
17
+ },
18
+ required: ["note_id"],
19
+ },
20
+ async handler(args) {
21
+ const raw = args?.raw;
22
+ const noteId = args?.note_id;
23
+ const data = await apiGet(`/notes/${noteId}`, undefined, "Get note");
24
+ return handleApiCall(data, formatNote, raw);
25
+ },
26
+ };
27
+ //# sourceMappingURL=get-note.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-note.js","sourceRoot":"","sources":["../../src/note/get-note.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGhE,MAAM,CAAC,MAAM,OAAO,GAAY;IAC9B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,gEAAgE;IAE7E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;YAC9D,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8DAA8D,EAAE;SACtG;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,GAAG,GAAG,IAAI,EAAE,GAA0B,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,EAAE,OAAiB,CAAC;QAEvC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,MAAM,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACrE,OAAO,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC"}
@@ -0,0 +1,6 @@
1
+ export { noteList } from "./list-notes.js";
2
+ export { noteGet } from "./get-note.js";
3
+ export { noteCreate } from "./create-note.js";
4
+ export { noteUpdate } from "./update-note.js";
5
+ import type { McpTool } from "../common/types.js";
6
+ export declare const noteTools: McpTool[];
@@ -0,0 +1,10 @@
1
+ export { noteList } from "./list-notes.js";
2
+ export { noteGet } from "./get-note.js";
3
+ export { noteCreate } from "./create-note.js";
4
+ export { noteUpdate } from "./update-note.js";
5
+ import { noteList } from "./list-notes.js";
6
+ import { noteGet } from "./get-note.js";
7
+ import { noteCreate } from "./create-note.js";
8
+ import { noteUpdate } from "./update-note.js";
9
+ export const noteTools = [noteList, noteGet, noteCreate, noteUpdate];
10
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/note/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,CAAC,MAAM,SAAS,GAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * note/list — 获取小记列表
3
+ *
4
+ * 端点:GET /api/v2/notes
5
+ * 职责:返回当前用户的小记列表(含置顶)
6
+ */
7
+ import type { McpTool } from "../common/types.js";
8
+ export declare const noteList: McpTool;
@@ -0,0 +1,40 @@
1
+ /**
2
+ * note/list — 获取小记列表
3
+ *
4
+ * 端点:GET /api/v2/notes
5
+ * 职责:返回当前用户的小记列表(含置顶)
6
+ */
7
+ import { apiGet } from "../common/api-client.js";
8
+ import { formatNoteSummary, handleApiCall } from "../common/format.js";
9
+ export const noteList = {
10
+ name: "yuque_list_notes",
11
+ description: "List current user's notes. GET /notes. 详见 references/api/note_api.md",
12
+ inputSchema: {
13
+ type: "object",
14
+ properties: {
15
+ status: { type: "number", description: "Status filter: 0=active, 9=deleted" },
16
+ page: { type: "number", description: "Page number, default 1" },
17
+ limit: { type: "number", description: "Page size, default 20" },
18
+ },
19
+ },
20
+ async handler(args) {
21
+ const raw = args?.raw;
22
+ const status = args?.status;
23
+ const page = args?.page ?? 1;
24
+ const limit = args?.limit ?? 20;
25
+ const params = {
26
+ page: String(page),
27
+ limit: String(limit),
28
+ };
29
+ if (status !== undefined)
30
+ params.status = String(status);
31
+ const data = await apiGet("/notes", params, "List notes");
32
+ const notes = data?.data;
33
+ const formatted = {
34
+ pin_notes: (notes?.pin_notes ?? []).map((n) => formatNoteSummary(n)),
35
+ notes: (notes?.notes ?? []).map((n) => formatNoteSummary(n)),
36
+ };
37
+ return handleApiCall(raw ? data : formatted, undefined, raw);
38
+ },
39
+ };
40
+ //# sourceMappingURL=list-notes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"list-notes.js","sourceRoot":"","sources":["../../src/note/list-notes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGvE,MAAM,CAAC,MAAM,QAAQ,GAAY;IAC/B,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,sEAAsE;IAEnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;YAC7E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;YAC/D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;SAChE;KACF;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,GAAG,GAAG,IAAI,EAAE,GAA0B,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,EAAE,MAA4B,CAAC;QAClD,MAAM,IAAI,GAAI,IAAI,EAAE,IAAe,IAAI,CAAC,CAAC;QACzC,MAAM,KAAK,GAAI,IAAI,EAAE,KAAgB,IAAI,EAAE,CAAC;QAE5C,MAAM,MAAM,GAA2B;YACrC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;YAClB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;SACrB,CAAC;QACF,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAEzD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAI,IAAgE,EAAE,IAAI,CAAC;QACtF,MAAM,SAAS,GAAG;YAChB,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAA4C,CAAC,CAAC;YAC/G,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAA4C,CAAC,CAAC;SACxG,CAAC;QACF,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,SAAgB,EAAE,GAAG,CAAC,CAAC;IACtE,CAAC;CACF,CAAC"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * note/update — 更新或删除小记
3
+ *
4
+ * 端点:PUT /api/v2/notes/:id
5
+ * 职责:更新小记内容或软删除(status=9)
6
+ */
7
+ import type { McpTool } from "../common/types.js";
8
+ export declare const noteUpdate: McpTool;
@@ -0,0 +1,53 @@
1
+ /**
2
+ * note/update — 更新或删除小记
3
+ *
4
+ * 端点:PUT /api/v2/notes/:id
5
+ * 职责:更新小记内容或软删除(status=9)
6
+ */
7
+ import { confirmationParam, checkConfirmation } from "../common/errors.js";
8
+ import { apiPut } from "../common/api-client.js";
9
+ import { formatNote, handleApiCall } from "../common/format.js";
10
+ export const noteUpdate = {
11
+ name: "yuque_update_note",
12
+ description: "Update or delete a note. ⚠️ Deleting (status=9) requires confirm='DELETE'. PUT /notes/:id. 详见 references/api/note_api.md",
13
+ inputSchema: {
14
+ type: "object",
15
+ properties: {
16
+ note_id: { type: "number", description: "Note ID (required)" },
17
+ body: { type: "string", description: "New content (plain text or Markdown, unchanged if omitted)" },
18
+ status: { type: "number", description: "Status: 0=active, 9=deleted (unchanged if omitted)" },
19
+ confirm: confirmationParam.confirm,
20
+ raw: { type: "boolean", description: "Return raw full JSON (default false, returns trimmed fields)" },
21
+ },
22
+ required: ["note_id"],
23
+ },
24
+ async handler(args) {
25
+ const raw = args?.raw;
26
+ const noteId = args?.note_id;
27
+ const body = args?.body;
28
+ const status = args?.status;
29
+ if (status === 9) {
30
+ const confirmed = checkConfirmation(args);
31
+ if (confirmed)
32
+ return confirmed;
33
+ }
34
+ const payload = {};
35
+ if (body !== undefined) {
36
+ payload.body = body;
37
+ payload.html = `<p>${body}</p>`;
38
+ payload.source = body;
39
+ payload.abstract = body.substring(0, 200);
40
+ }
41
+ if (status !== undefined)
42
+ payload.status = status;
43
+ if (Object.keys(payload).length === 0) {
44
+ return {
45
+ content: [{ type: "text", text: JSON.stringify({ error: "至少需要传 body 或 status" }, null, 2) }],
46
+ isError: true,
47
+ };
48
+ }
49
+ const data = await apiPut(`/notes/${noteId}`, payload, "Update note");
50
+ return handleApiCall(data, formatNote, raw);
51
+ },
52
+ };
53
+ //# sourceMappingURL=update-note.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"update-note.js","sourceRoot":"","sources":["../../src/note/update-note.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAiB,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGhE,MAAM,CAAC,MAAM,UAAU,GAAY;IACjC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,0HAA0H;IAEvI,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;YAC9D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4DAA4D,EAAE;YACnG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oDAAoD,EAAE;YAC7F,OAAO,EAAE,iBAAiB,CAAC,OAAO;YAClC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8DAA8D,EAAE;SACtG;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,GAAG,GAAG,IAAI,EAAE,GAA0B,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,EAAE,OAAiB,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,EAAE,IAA0B,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,EAAE,MAA4B,CAAC;QAElD,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,SAAS;gBAAE,OAAO,SAAS,CAAC;QAClC,CAAC;QAED,MAAM,OAAO,GAA4B,EAAE,CAAC;QAC5C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;YACpB,OAAO,CAAC,IAAI,GAAG,MAAM,IAAI,MAAM,CAAC;YAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YACtB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QAElD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBACrG,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QACtE,OAAO,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC"}
@@ -0,0 +1,4 @@
1
+ /**
2
+ * recycle/common — recycle 域公共常量
3
+ */
4
+ export declare const MINE_BASE = "https://www.yuque.com/api/mine/recycles";
@@ -0,0 +1,5 @@
1
+ /**
2
+ * recycle/common — recycle 域公共常量
3
+ */
4
+ export const MINE_BASE = "https://www.yuque.com/api/mine/recycles";
5
+ //# sourceMappingURL=common.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/recycle/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,yCAAyC,CAAC"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * recycle/destroy — 彻底删除回收站项目
3
+ *
4
+ * 端点:DELETE /api/mine/recycles/:id(Web API,Cookie 认证)
5
+ * ⚠️ 不可恢复
6
+ */
7
+ import type { McpTool } from "../common/types.js";
8
+ export declare const recycleDestroy: McpTool;
@@ -0,0 +1,38 @@
1
+ /**
2
+ * recycle/destroy — 彻底删除回收站项目
3
+ *
4
+ * 端点:DELETE /api/mine/recycles/:id(Web API,Cookie 认证)
5
+ * ⚠️ 不可恢复
6
+ */
7
+ import { confirmationParam, checkConfirmation } from "../common/errors.js";
8
+ import { webRequest } from "../common/web-request.js";
9
+ import { MINE_BASE } from "./common.js";
10
+ const RECYCLE_REFERER = "https://www.yuque.com/dashboard/recycles";
11
+ export const recycleDestroy = {
12
+ name: "yuque_destroy_recycle",
13
+ description: "Permanently delete a recycle bin item (⚠️ irreversible, requires cookie+ctoken). Requires confirm='DELETE'. DELETE /mine/recycles/:id. 详见 references/api/recycle_api.md",
14
+ inputSchema: {
15
+ type: "object",
16
+ properties: {
17
+ recycle_id: { type: "number", description: "Recycle bin item ID (required)" },
18
+ confirm: confirmationParam.confirm,
19
+ },
20
+ required: ["recycle_id", "confirm"],
21
+ },
22
+ async handler(args) {
23
+ const confirmed = checkConfirmation(args);
24
+ if (confirmed)
25
+ return confirmed;
26
+ const recycleId = args?.recycle_id;
27
+ await webRequest(`${MINE_BASE}/${recycleId}`, { method: "DELETE", referer: RECYCLE_REFERER });
28
+ return {
29
+ content: [
30
+ {
31
+ type: "text",
32
+ text: JSON.stringify({ destroyed: true, recycle_id: recycleId }, null, 2),
33
+ },
34
+ ],
35
+ };
36
+ },
37
+ };
38
+ //# sourceMappingURL=destroy-recycle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"destroy-recycle.js","sourceRoot":"","sources":["../../src/recycle/destroy-recycle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,eAAe,GAAG,0CAA0C,CAAC;AAEnE,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,yKAAyK;IAEtL,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;YAC7E,OAAO,EAAE,iBAAiB,CAAC,OAAO;SACnC;QACD,QAAQ,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC;KACpC;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;QAEhC,MAAM,SAAS,GAAG,IAAI,EAAE,UAAoB,CAAC;QAE7C,MAAM,UAAU,CAAC,GAAG,SAAS,IAAI,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;QAE9F,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC1E;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}
@@ -0,0 +1,5 @@
1
+ export { recycleList } from "./list-recycles.js";
2
+ export { recycleRestore } from "./restore-recycle.js";
3
+ export { recycleDestroy } from "./destroy-recycle.js";
4
+ import type { McpTool } from "../common/types.js";
5
+ export declare const recycleTools: McpTool[];
@@ -0,0 +1,8 @@
1
+ export { recycleList } from "./list-recycles.js";
2
+ export { recycleRestore } from "./restore-recycle.js";
3
+ export { recycleDestroy } from "./destroy-recycle.js";
4
+ import { recycleList } from "./list-recycles.js";
5
+ import { recycleRestore } from "./restore-recycle.js";
6
+ import { recycleDestroy } from "./destroy-recycle.js";
7
+ export const recycleTools = [recycleList, recycleRestore, recycleDestroy];
8
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recycle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,CAAC,MAAM,YAAY,GAAc,CAAC,WAAW,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * recycle/list — 列出回收站项目
3
+ *
4
+ * 端点:GET /api/mine/recycles(Web API,Cookie 认证)
5
+ * 职责:返回当前用户的回收站列表
6
+ */
7
+ import type { McpTool } from "../common/types.js";
8
+ export declare const recycleList: McpTool;
@@ -0,0 +1,57 @@
1
+ /**
2
+ * recycle/list — 列出回收站项目
3
+ *
4
+ * 端点:GET /api/mine/recycles(Web API,Cookie 认证)
5
+ * 职责:返回当前用户的回收站列表
6
+ */
7
+ import { webRequest } from "../common/web-request.js";
8
+ import { MINE_BASE } from "./common.js";
9
+ const RECYCLE_REFERER = "https://www.yuque.com/dashboard/recycles";
10
+ export const recycleList = {
11
+ name: "yuque_list_recycles",
12
+ description: "List recycle bin items (requires cookie+ctoken). GET /mine/recycles. 详见 references/api/recycle_api.md",
13
+ inputSchema: {
14
+ type: "object",
15
+ properties: {
16
+ offset: { type: "number", description: "Pagination offset, default 0" },
17
+ limit: { type: "number", description: "Page size, max 100, default 50" },
18
+ target_type: { type: "string", description: "Target type filter: Doc, Note, Repo" },
19
+ },
20
+ },
21
+ async handler(args) {
22
+ const offset = args?.offset ?? 0;
23
+ const limit = Math.min(args?.limit ?? 50, 100);
24
+ const targetType = args?.target_type;
25
+ let url = `${MINE_BASE}?offset=${offset}&limit=${limit}`;
26
+ if (targetType)
27
+ url += `&target_type=${targetType}`;
28
+ const data = (await webRequest(url, { referer: RECYCLE_REFERER }));
29
+ const items = data?.data?.data || [];
30
+ const total = data?.data?.total ?? items.length;
31
+ const formatted = items.map((r) => {
32
+ const params = (r.params || {});
33
+ const doc = (params.doc || {});
34
+ const book = (params.book || {});
35
+ return {
36
+ id: r.id,
37
+ target_id: r.target_id,
38
+ target_type: r.target_type,
39
+ created_at: r.created_at,
40
+ title: doc.title || book.name || "",
41
+ slug: doc.slug || book.slug || "",
42
+ book: params.book
43
+ ? { id: book.id, name: book.name, slug: book.slug }
44
+ : null,
45
+ };
46
+ });
47
+ return {
48
+ content: [
49
+ {
50
+ type: "text",
51
+ text: JSON.stringify({ total, offset, limit, items: formatted }, null, 2),
52
+ },
53
+ ],
54
+ };
55
+ },
56
+ };
57
+ //# sourceMappingURL=list-recycles.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"list-recycles.js","sourceRoot":"","sources":["../../src/recycle/list-recycles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,eAAe,GAAG,0CAA0C,CAAC;AAEnE,MAAM,CAAC,MAAM,WAAW,GAAY;IAClC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,uGAAuG;IAEpH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;YACvE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;YACxE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;SACpF;KACF;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,MAAM,GAAI,IAAI,EAAE,MAAiB,IAAI,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAE,IAAI,EAAE,KAAgB,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,IAAI,EAAE,WAAiC,CAAC;QAE3D,IAAI,GAAG,GAAG,GAAG,SAAS,WAAW,MAAM,UAAU,KAAK,EAAE,CAAC;QACzD,IAAI,UAAU;YAAE,GAAG,IAAI,gBAAgB,UAAU,EAAE,CAAC;QAEpD,MAAM,IAAI,GAAG,CAAC,MAAM,UAAU,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAyE,CAAC;QAC3I,MAAM,KAAK,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,EAAE,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC;QAEhD,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAA0B,EAAE,EAAE;YACzD,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAA4B,CAAC;YAC3D,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAA4B,CAAC;YAC1D,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;YAC5D,OAAO;gBACL,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE;gBACnC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE;gBACjC,IAAI,EAAE,MAAM,CAAC,IAAI;oBACf,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;oBACnD,CAAC,CAAC,IAAI;aACT,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC1E;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * recycle/restore — 恢复回收站项目
3
+ *
4
+ * 端点:PUT /api/mine/recycles/:id/restore(Web API,Cookie 认证)
5
+ */
6
+ import type { McpTool } from "../common/types.js";
7
+ export declare const recycleRestore: McpTool;
@@ -0,0 +1,32 @@
1
+ /**
2
+ * recycle/restore — 恢复回收站项目
3
+ *
4
+ * 端点:PUT /api/mine/recycles/:id/restore(Web API,Cookie 认证)
5
+ */
6
+ import { webRequest } from "../common/web-request.js";
7
+ import { MINE_BASE } from "./common.js";
8
+ const RECYCLE_REFERER = "https://www.yuque.com/dashboard/recycles";
9
+ export const recycleRestore = {
10
+ name: "yuque_restore_recycle",
11
+ description: "Restore an item from recycle bin (requires cookie+ctoken). PUT /mine/recycles/:id/restore. 详见 references/api/recycle_api.md",
12
+ inputSchema: {
13
+ type: "object",
14
+ properties: {
15
+ recycle_id: { type: "number", description: "Recycle bin item ID (required)" },
16
+ },
17
+ required: ["recycle_id"],
18
+ },
19
+ async handler(args) {
20
+ const recycleId = args?.recycle_id;
21
+ await webRequest(`${MINE_BASE}/${recycleId}/restore`, { method: "PUT", referer: RECYCLE_REFERER });
22
+ return {
23
+ content: [
24
+ {
25
+ type: "text",
26
+ text: JSON.stringify({ restored: true, recycle_id: recycleId }, null, 2),
27
+ },
28
+ ],
29
+ };
30
+ },
31
+ };
32
+ //# sourceMappingURL=restore-recycle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"restore-recycle.js","sourceRoot":"","sources":["../../src/recycle/restore-recycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,eAAe,GAAG,0CAA0C,CAAC;AAEnE,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,6HAA6H;IAE1I,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;SAC9E;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,SAAS,GAAG,IAAI,EAAE,UAAoB,CAAC;QAE7C,MAAM,UAAU,CAAC,GAAG,SAAS,IAAI,SAAS,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;QAEnG,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACzE;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * repo/batch-get — 批量获取知识库详情
3
+ *
4
+ * 并发 GET /api/v2/repos/:book_id
5
+ * 只读操作,不涉及写
6
+ */
7
+ import type { McpTool } from "../common/types.js";
8
+ export declare const repoBatchGet: McpTool;
@@ -0,0 +1,83 @@
1
+ /**
2
+ * repo/batch-get — 批量获取知识库详情
3
+ *
4
+ * 并发 GET /api/v2/repos/:book_id
5
+ * 只读操作,不涉及写
6
+ */
7
+ import { apiGet, isErrorResult } from "../common/api-client.js";
8
+ import { requiredString } from "../common/validate.js";
9
+ export const repoBatchGet = {
10
+ name: "yuque_batch_get_repos",
11
+ description: "Batch get repo details (concurrent GET, read-only, max 20). 详见 references/api/repo_api.md",
12
+ inputSchema: {
13
+ type: "object",
14
+ properties: {
15
+ ids: {
16
+ type: "string",
17
+ description: "Repository IDs as JSON array, e.g. [123,456] or [\"group/repo-a\",\"group/repo-b\"] (required, max 20)",
18
+ },
19
+ },
20
+ required: ["ids"],
21
+ },
22
+ async handler(args) {
23
+ const idsRaw = args?.ids;
24
+ const v = requiredString(idsRaw, "ids");
25
+ if (v)
26
+ return v;
27
+ let ids;
28
+ try {
29
+ ids = JSON.parse(idsRaw);
30
+ }
31
+ catch {
32
+ return {
33
+ content: [{ type: "text", text: JSON.stringify({
34
+ error: "ids 必须是合法 JSON 数组 / ids must be a valid JSON array",
35
+ hint: "zh/en",
36
+ }, null, 2) }],
37
+ isError: true,
38
+ };
39
+ }
40
+ if (!Array.isArray(ids) || ids.length === 0) {
41
+ return {
42
+ content: [{ type: "text", text: JSON.stringify({
43
+ error: "ids 不能为空数组 / ids must be a non-empty array",
44
+ hint: "zh/en",
45
+ }, null, 2) }],
46
+ isError: true,
47
+ };
48
+ }
49
+ if (ids.length > 20) {
50
+ return {
51
+ content: [{ type: "text", text: JSON.stringify({
52
+ error: "ids 最多 20 个 / ids max 20",
53
+ hint: "zh/en",
54
+ }, null, 2) }],
55
+ isError: true,
56
+ };
57
+ }
58
+ const results = await Promise.all(ids.map((id) => apiGet(`/repos/${encodeURIComponent(String(id))}`, undefined, `Get repo ${id}`).then((data) => {
59
+ if (isErrorResult(data))
60
+ return { id, error: true, detail: data };
61
+ return { id, ok: true, data };
62
+ })));
63
+ const output = {};
64
+ const errors = [];
65
+ for (const r of results) {
66
+ if (r.error) {
67
+ errors.push({ id: r.id, detail: r.detail });
68
+ }
69
+ else if (r.ok && r.data) {
70
+ output[String(r.id)] = r.data?.data ?? r.data;
71
+ }
72
+ }
73
+ const response = { total: ids.length, ok: Object.keys(output).length };
74
+ if (Object.keys(output).length > 0)
75
+ response.repos = output;
76
+ if (errors.length > 0)
77
+ response.errors = errors;
78
+ return {
79
+ content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
80
+ };
81
+ },
82
+ };
83
+ //# sourceMappingURL=batch-get-repos.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"batch-get-repos.js","sourceRoot":"","sources":["../../src/repo/batch-get-repos.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAS,MAAM,uBAAuB,CAAC;AAG9D,MAAM,CAAC,MAAM,YAAY,GAAY;IACnC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,2FAA2F;IAExG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wGAAwG;aACtH;SACF;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;KAClB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,MAAM,GAAG,IAAI,EAAE,GAAa,CAAC;QAEnC,MAAM,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QAEhB,IAAI,GAAwB,CAAC;QAC7B,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACtD,KAAK,EAAE,oDAAoD;4BAC3D,IAAI,EAAE,OAAO;yBACd,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBACd,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5C,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACtD,KAAK,EAAE,4CAA4C;4BACnD,IAAI,EAAE,OAAO;yBACd,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBACd,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACtD,KAAK,EAAE,0BAA0B;4BACjC,IAAI,EAAE,OAAO;yBACd,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBACd,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CACb,MAAM,CAAC,UAAU,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAa,EAAE,EAAE;YACrG,IAAI,aAAa,CAAC,IAAI,CAAC;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YAClE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAChC,CAAC,CAAC,CACH,CACF,CAAC;QAEF,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAoD,EAAE,CAAC;QAEnE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAqB,EAAE,MAAM,EAAG,CAAS,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1E,CAAC;iBAAM,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC1B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAI,CAAC,CAAC,IAAY,EAAE,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC;YACzD,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAA4B,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;QAChG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,QAAQ,CAAC,KAAK,GAAG,MAAM,CAAC;QAC5D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;QAEhD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC9E,CAAC;IACJ,CAAC;CACF,CAAC"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * repo/copy-repo — 批量跨知识库文档复制
3
+ *
4
+ * Agent 清洗内容后传入 documents 数组,工具串行建目录+创建文档
5
+ */
6
+ import type { McpTool } from "../common/types.js";
7
+ export declare const repoCopy: McpTool;