@cyanheads/biorxiv-mcp-server 0.1.17 → 0.2.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.
Files changed (42) hide show
  1. package/AGENTS.md +1 -1
  2. package/CLAUDE.md +1 -1
  3. package/README.md +25 -8
  4. package/changelog/0.1.x/0.1.18.md +16 -0
  5. package/changelog/0.2.x/0.2.0.md +12 -0
  6. package/dist/config/server-config.d.ts +2 -0
  7. package/dist/config/server-config.d.ts.map +1 -1
  8. package/dist/config/server-config.js +14 -0
  9. package/dist/config/server-config.js.map +1 -1
  10. package/dist/index.js +2 -0
  11. package/dist/index.js.map +1 -1
  12. package/dist/mcp-server/tools/definitions/biorxiv-get-fulltext.tool.d.ts +65 -0
  13. package/dist/mcp-server/tools/definitions/biorxiv-get-fulltext.tool.d.ts.map +1 -0
  14. package/dist/mcp-server/tools/definitions/biorxiv-get-fulltext.tool.js +209 -0
  15. package/dist/mcp-server/tools/definitions/biorxiv-get-fulltext.tool.js.map +1 -0
  16. package/dist/mcp-server/tools/definitions/biorxiv-list-recent.tool.d.ts.map +1 -1
  17. package/dist/mcp-server/tools/definitions/biorxiv-list-recent.tool.js +33 -21
  18. package/dist/mcp-server/tools/definitions/biorxiv-list-recent.tool.js.map +1 -1
  19. package/dist/mcp-server/tools/definitions/biorxiv-search-preprints.tool.d.ts +7 -2
  20. package/dist/mcp-server/tools/definitions/biorxiv-search-preprints.tool.d.ts.map +1 -1
  21. package/dist/mcp-server/tools/definitions/biorxiv-search-preprints.tool.js +59 -15
  22. package/dist/mcp-server/tools/definitions/biorxiv-search-preprints.tool.js.map +1 -1
  23. package/dist/mcp-server/tools/definitions/index.d.ts +58 -2
  24. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  25. package/dist/mcp-server/tools/definitions/index.js +3 -0
  26. package/dist/mcp-server/tools/definitions/index.js.map +1 -1
  27. package/dist/services/biorxiv-fulltext/biorxiv-fulltext-service.d.ts +52 -0
  28. package/dist/services/biorxiv-fulltext/biorxiv-fulltext-service.d.ts.map +1 -0
  29. package/dist/services/biorxiv-fulltext/biorxiv-fulltext-service.js +156 -0
  30. package/dist/services/biorxiv-fulltext/biorxiv-fulltext-service.js.map +1 -0
  31. package/dist/services/europe-pmc/europe-pmc-service.d.ts +6 -1
  32. package/dist/services/europe-pmc/europe-pmc-service.d.ts.map +1 -1
  33. package/dist/services/europe-pmc/europe-pmc-service.js +20 -3
  34. package/dist/services/europe-pmc/europe-pmc-service.js.map +1 -1
  35. package/dist/services/europe-pmc/types.d.ts +6 -0
  36. package/dist/services/europe-pmc/types.d.ts.map +1 -1
  37. package/dist/services/shared.d.ts +12 -0
  38. package/dist/services/shared.d.ts.map +1 -1
  39. package/dist/services/shared.js +21 -0
  40. package/dist/services/shared.js.map +1 -1
  41. package/package.json +3 -1
  42. package/server.json +3 -3
@@ -0,0 +1,156 @@
1
+ /**
2
+ * @fileoverview BiorxivFullTextService — fetches a preprint's rendered full-text
3
+ * HTML page from the bioRxiv/medRxiv website (`www.{server}.org/content/{doi}v{N}.full`)
4
+ * and extracts readable Markdown via the framework HTML extractor.
5
+ *
6
+ * This is a DISTINCT fetch path from BiorxivApiService: it EXPECTS an HTML
7
+ * document (the rendered article page), so it never routes through the JSON
8
+ * API's "HTML response = upstream error" guard. Cloudflare challenge/block pages
9
+ * and empty extractions are surfaced as a typed `unavailable` result rather than
10
+ * crashing or feeding interstitial garbage to the extractor.
11
+ * @module services/biorxiv-fulltext/biorxiv-fulltext-service
12
+ */
13
+ import { McpError } from '@cyanheads/mcp-ts-core/errors';
14
+ import { fetchWithTimeout, htmlExtractor, withRetry } from '@cyanheads/mcp-ts-core/utils';
15
+ import { getServerConfig } from '../../config/server-config.js';
16
+ import { asRc, SERVER_VERSION } from '../../services/shared.js';
17
+ /**
18
+ * bioRxiv/medRxiv render their article pages on the Highwire platform, whose
19
+ * main full-text container is `<div class="article fulltext-view">`. Defuddle's
20
+ * auto-detection latches onto the reference apparatus on these pages and misses
21
+ * the body; pointing it at this selector captures the full article text. When
22
+ * the selector matches nothing, Defuddle falls back to auto-detection, so it is
23
+ * always safe to pass.
24
+ */
25
+ const FULLTEXT_CONTENT_SELECTOR = '.fulltext-view';
26
+ /**
27
+ * HTTP statuses for which a re-fetch will never succeed — the full-text page is
28
+ * blocked, missing, or legally unavailable at this origin. Classified as a
29
+ * deterministic `unavailable` result (routing the agent to metadata) rather than
30
+ * bubbling as a transient error the framework would advertise as retryable. 403
31
+ * is what medRxiv's Cloudflare edge returns for programmatic access.
32
+ */
33
+ const DETERMINISTIC_UNAVAILABLE_STATUSES = new Set([401, 403, 404, 410, 451]);
34
+ /**
35
+ * Markers unique to Cloudflare's interstitial / block pages. Deliberately narrow:
36
+ * a genuine bioRxiv article page references `cloudflare-static/email-decode.min.js`
37
+ * and reCAPTCHA form scripts, so a bare "cloudflare"/"captcha" match would
38
+ * false-positive. These strings appear only on the challenge/block pages.
39
+ */
40
+ const CHALLENGE_MARKERS = [
41
+ 'Attention Required! | Cloudflare',
42
+ 'cf-error-details',
43
+ 'cf-browser-verification',
44
+ 'cf-challenge-running',
45
+ '_cf_chl_opt',
46
+ 'Checking your browser before accessing',
47
+ 'Just a moment...',
48
+ ];
49
+ function isChallengePage(html) {
50
+ return CHALLENGE_MARKERS.some((marker) => html.includes(marker));
51
+ }
52
+ export class BiorxivFullTextService {
53
+ webBaseUrls;
54
+ userAgent;
55
+ constructor(_config, _storage) {
56
+ const serverCfg = getServerConfig();
57
+ this.webBaseUrls = {
58
+ biorxiv: serverCfg.biorxivWebBaseUrl,
59
+ medrxiv: serverCfg.medrxivWebBaseUrl,
60
+ };
61
+ this.userAgent = serverCfg.mailto
62
+ ? `biorxiv-mcp-server/${SERVER_VERSION} (mailto:${serverCfg.mailto})`
63
+ : `biorxiv-mcp-server/${SERVER_VERSION}`;
64
+ }
65
+ /**
66
+ * Fetch and extract the full-text Markdown for a specific preprint version.
67
+ *
68
+ * Resolves to `{ kind: 'article', markdown, ... }` on success, or
69
+ * `{ kind: 'unavailable', reason }` when the page is blocked (Cloudflare 403 /
70
+ * challenge), missing, or yields no extractable text (PDF-only preprints).
71
+ * Transient failures (5xx, timeout, network) bubble as `ServiceUnavailable`
72
+ * after retry so the framework classifies them as retryable.
73
+ */
74
+ async fetchFullText(server, doi, version, ctx) {
75
+ const encodedDoi = doi.split('/').map(encodeURIComponent).join('/');
76
+ const sourceUrl = `${this.webBaseUrls[server]}/content/${encodedDoi}v${version}.full`;
77
+ const rc = asRc(ctx);
78
+ let html;
79
+ try {
80
+ html = await withRetry(async () => {
81
+ const response = await fetchWithTimeout(sourceUrl, 30_000, rc, {
82
+ signal: ctx.signal,
83
+ headers: { 'User-Agent': this.userAgent, Accept: 'text/html' },
84
+ });
85
+ return await response.text();
86
+ }, {
87
+ operation: 'BiorxivFullTextService.fetchFullText',
88
+ context: rc,
89
+ baseDelayMs: 500,
90
+ signal: ctx.signal,
91
+ });
92
+ }
93
+ catch (err) {
94
+ // fetchWithTimeout throws on non-2xx with data.statusCode set. Deterministic
95
+ // access failures (403 block, 404 missing) become an `unavailable` result;
96
+ // transient codes (5xx / timeout / network) bubble unchanged as ServiceUnavailable.
97
+ const status = err instanceof McpError &&
98
+ typeof err.data?.statusCode === 'number'
99
+ ? err.data.statusCode
100
+ : undefined;
101
+ if (status !== undefined && DETERMINISTIC_UNAVAILABLE_STATUSES.has(status)) {
102
+ ctx.log.info('Full-text HTML page unavailable', { sourceUrl, status });
103
+ return {
104
+ kind: 'unavailable',
105
+ reason: 'blocked',
106
+ detail: `The full-text HTML page is not accessible (HTTP ${status}). The origin may restrict programmatic access, or this version has no rendered HTML page.`,
107
+ sourceUrl,
108
+ };
109
+ }
110
+ throw err;
111
+ }
112
+ // Defense in depth: a challenge/interstitial served with a 2xx status would
113
+ // otherwise be handed to the extractor as if it were the article body.
114
+ if (isChallengePage(html)) {
115
+ ctx.log.warning('Full-text page returned a bot-challenge/interstitial', { sourceUrl });
116
+ return {
117
+ kind: 'unavailable',
118
+ reason: 'blocked',
119
+ detail: 'The full-text page returned a bot-challenge/interstitial instead of the article. The origin is blocking programmatic access from this host.',
120
+ sourceUrl,
121
+ };
122
+ }
123
+ const extracted = await htmlExtractor.extract(html, {
124
+ url: sourceUrl,
125
+ format: 'markdown',
126
+ contentSelector: FULLTEXT_CONTENT_SELECTOR,
127
+ });
128
+ const markdown = extracted.content.trim();
129
+ if (!markdown) {
130
+ return {
131
+ kind: 'unavailable',
132
+ reason: 'empty',
133
+ detail: 'The full-text page contained no extractable article text — the preprint may be PDF-only, or the page carries figures without body text.',
134
+ sourceUrl,
135
+ };
136
+ }
137
+ return {
138
+ kind: 'article',
139
+ markdown,
140
+ ...(extracted.title && { title: extracted.title }),
141
+ ...(typeof extracted.wordCount === 'number' && { wordCount: extracted.wordCount }),
142
+ sourceUrl,
143
+ };
144
+ }
145
+ }
146
+ // ─── Init / accessor ─────────────────────────────────────────────────────────
147
+ let _service;
148
+ export function initBiorxivFullTextService(config, storage) {
149
+ _service = new BiorxivFullTextService(config, storage);
150
+ }
151
+ export function getBiorxivFullTextService() {
152
+ if (!_service)
153
+ throw new Error('BiorxivFullTextService not initialized — call initBiorxivFullTextService() in setup()');
154
+ return _service;
155
+ }
156
+ //# sourceMappingURL=biorxiv-fulltext-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"biorxiv-fulltext-service.js","sourceRoot":"","sources":["../../../src/services/biorxiv-fulltext/biorxiv-fulltext-service.ts"],"names":[],"mappings":"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"}
@@ -10,13 +10,18 @@ import type { AppConfig } from '@cyanheads/mcp-ts-core/config';
10
10
  import type { StorageService } from '@cyanheads/mcp-ts-core/storage';
11
11
  import type { EuropePmcSearchResult } from './types.js';
12
12
  export interface SearchOptions {
13
+ /** Optional author filter — ANDed into the query as an `AUTH:"…"` clause. */
14
+ author?: string | undefined;
15
+ /** Opaque EuropePMC cursor for the page to fetch. Defaults to '*' (first page). */
16
+ cursorMark?: string | undefined;
13
17
  /** Optional date filter — format YYYY-MM-DD */
14
18
  dateFrom?: string | undefined;
15
19
  /** Optional date filter — format YYYY-MM-DD */
16
20
  dateTo?: string | undefined;
17
21
  /** Maximum number of results to return (capped at 100) */
18
22
  limit?: number | undefined;
19
- query: string;
23
+ /** Free-text keyword query. Optional when `author` is supplied. */
24
+ query?: string | undefined;
20
25
  /** Server filter: 'biorxiv' | 'medrxiv' | 'both' */
21
26
  server?: string | undefined;
22
27
  }
@@ -1 +1 @@
1
- {"version":3,"file":"europe-pmc-service.d.ts","sourceRoot":"","sources":["../../../src/services/europe-pmc/europe-pmc-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE,OAAO,KAAK,EAEV,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc;IAQxD;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAyEnF;AAMD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAErF;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAItD"}
1
+ {"version":3,"file":"europe-pmc-service.d.ts","sourceRoot":"","sources":["../../../src/services/europe-pmc/europe-pmc-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE,OAAO,KAAK,EAEV,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc;IAQxD;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAyFnF;AAMD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAErF;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAItD"}
@@ -27,7 +27,18 @@ export class EuropePmcService {
27
27
  */
28
28
  async search(options, ctx) {
29
29
  const limit = Math.min(options.limit ?? 25, 100);
30
- let q = options.query;
30
+ // Base terms: the free-text keyword query and/or an AUTH: author clause.
31
+ // At least one is guaranteed non-empty by the tool's input refinement.
32
+ const terms = [];
33
+ const keyword = options.query?.trim();
34
+ if (keyword)
35
+ terms.push(keyword);
36
+ const author = options.author?.trim();
37
+ if (author) {
38
+ // Strip embedded double-quotes so a stray quote can't break the AUTH phrase.
39
+ terms.push(`AUTH:"${author.replace(/"/g, '')}"`);
40
+ }
41
+ let q = terms.join(' AND ');
31
42
  if (options.dateFrom || options.dateTo) {
32
43
  const from = options.dateFrom ?? '1900-01-01';
33
44
  const to = options.dateTo ?? '9999-12-31';
@@ -50,7 +61,7 @@ export class EuropePmcService {
50
61
  query: q,
51
62
  resulttype: 'lite',
52
63
  synonym: 'FALSE',
53
- cursorMark: '*',
64
+ cursorMark: options.cursorMark ?? '*',
54
65
  pageSize: String(limit),
55
66
  format: 'json',
56
67
  fields,
@@ -80,7 +91,13 @@ export class EuropePmcService {
80
91
  ...(abstract && { abstract }),
81
92
  };
82
93
  });
83
- return { hitCount: data.hitCount ?? results.length, results };
94
+ return {
95
+ hitCount: data.hitCount ?? results.length,
96
+ results,
97
+ // Absent on the last page (EuropePMC omits it) — omit here too so
98
+ // callers read "no field" as "no more pages".
99
+ ...(data.nextCursorMark && { nextCursorMark: data.nextCursorMark }),
100
+ };
84
101
  }, {
85
102
  operation: 'EuropePmcService.search',
86
103
  context: rc,
@@ -1 +1 @@
1
- {"version":3,"file":"europe-pmc-service.js","sourceRoot":"","sources":["../../../src/services/europe-pmc/europe-pmc-service.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"europe-pmc-service.js","sourceRoot":"","sources":["../../../src/services/europe-pmc/europe-pmc-service.ts"],"names":[],"mappings":"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"}
@@ -34,6 +34,12 @@ export interface EuropePmcResult {
34
34
  export interface EuropePmcSearchResult {
35
35
  /** EuropePMC hitCount — total matching preprints regardless of the page size requested */
36
36
  hitCount: number;
37
+ /**
38
+ * Opaque cursor for the next page of ranked results. EuropePMC omits this
39
+ * field entirely on the final page (REST v6.6 termination semantics), so its
40
+ * absence — not a repeated value — signals that no further pages remain.
41
+ */
42
+ nextCursorMark?: string;
37
43
  results: EuropePmcResult[];
38
44
  }
39
45
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/europe-pmc/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yDAAyD;AACzD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE;QACX,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;KAC/B,CAAC;CACH;AAID,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,uGAAuG;AACvG,MAAM,WAAW,qBAAqB;IACpC,0FAA0F;IAC1F,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/europe-pmc/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yDAAyD;AACzD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE;QACX,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;KAC/B,CAAC;CACH;AAID,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,uGAAuG;AACvG,MAAM,WAAW,qBAAqB;IACpC,0FAA0F;IAC1F,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B"}
@@ -13,6 +13,18 @@ import type { RequestContext } from '@cyanheads/mcp-ts-core/utils';
13
13
  export declare function asRc(ctx: Context): RequestContext;
14
14
  /** Detect HTML error pages returned instead of JSON by upstream APIs. */
15
15
  export declare function detectHtmlError(text: string): boolean;
16
+ /**
17
+ * Validate that a `YYYY-MM-DD` string names a real calendar date. The shape
18
+ * regex callers gate on first still accepts day-of-month overflow inside a
19
+ * nominally valid month (`2024-02-30`, `2024-04-31`, `2023-02-29`), which
20
+ * `new Date(...)` silently rolls forward into the following month rather than
21
+ * rejecting. Construct a UTC date from the parsed numeric components and
22
+ * round-trip each field back to catch that overflow; genuine leap days
23
+ * (`2024-02-29`) round-trip cleanly and are accepted. A string that fails the
24
+ * shape match returns `false` rather than throwing, so it is safe to call
25
+ * without a prior regex gate.
26
+ */
27
+ export declare function isValidCalendarDate(dateStr: string): boolean;
16
28
  /**
17
29
  * Strip Highwire/JATS export artifacts that bioRxiv/medRxiv and EuropePMC leak
18
30
  * into raw title and abstract text, so no upstream markup reaches
@@ -1 +1 @@
1
- {"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/services/shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE;;;GAGG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAEjD;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAuBlF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,MAA4B,CAAC"}
1
+ {"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/services/shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE;;;GAGG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAEjD;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAU5D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAuBlF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,MAA4B,CAAC"}
@@ -16,6 +16,27 @@ export function asRc(ctx) {
16
16
  export function detectHtmlError(text) {
17
17
  return /^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text);
18
18
  }
19
+ /**
20
+ * Validate that a `YYYY-MM-DD` string names a real calendar date. The shape
21
+ * regex callers gate on first still accepts day-of-month overflow inside a
22
+ * nominally valid month (`2024-02-30`, `2024-04-31`, `2023-02-29`), which
23
+ * `new Date(...)` silently rolls forward into the following month rather than
24
+ * rejecting. Construct a UTC date from the parsed numeric components and
25
+ * round-trip each field back to catch that overflow; genuine leap days
26
+ * (`2024-02-29`) round-trip cleanly and are accepted. A string that fails the
27
+ * shape match returns `false` rather than throwing, so it is safe to call
28
+ * without a prior regex gate.
29
+ */
30
+ export function isValidCalendarDate(dateStr) {
31
+ const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(dateStr);
32
+ if (!match)
33
+ return false;
34
+ const year = Number(match[1]);
35
+ const month = Number(match[2]);
36
+ const day = Number(match[3]);
37
+ const date = new Date(Date.UTC(year, month - 1, day));
38
+ return (date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day);
39
+ }
19
40
  /**
20
41
  * Strip Highwire/JATS export artifacts that bioRxiv/medRxiv and EuropePMC leak
21
42
  * into raw title and abstract text, so no upstream markup reaches
@@ -1 +1 @@
1
- {"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/services/shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEnE;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,GAAY;IAC/B,OAAO,GAAgC,CAAC;AAC1C,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAwB;IAC5D,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,MAAM,OAAO,GAAG,IAAI;QAClB,0EAA0E;SACzE,OAAO,CAAC,qBAAqB,EAAE,GAAG,CAAC;QACpC,0EAA0E;SACzE,OAAO,CAAC,2BAA2B,EAAE,GAAG,CAAC;QAC1C,+EAA+E;SAC9E,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QAC5B,0EAA0E;SACzE,OAAO,CAAC,0BAA0B,EAAE,GAAG,CAAC;QACzC,4DAA4D;SAC3D,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;QAC7B,0CAA0C;SACzC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,sBAAsB,EAAE,GAAG,CAAC;QACrC,2EAA2E;QAC3E,6DAA6D;SAC5D,OAAO,CAAC,wEAAwE,EAAE,EAAE,CAAC;QACtF,uDAAuD;SACtD,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;IACV,OAAO,OAAO,IAAI,SAAS,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAW,WAAW,CAAC,OAAO,CAAC"}
1
+ {"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/services/shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEnE;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,GAAY;IAC/B,OAAO,GAAgC,CAAC;AAC1C,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,OAAO,CACL,IAAI,CAAC,cAAc,EAAE,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG,CAChG,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAwB;IAC5D,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,MAAM,OAAO,GAAG,IAAI;QAClB,0EAA0E;SACzE,OAAO,CAAC,qBAAqB,EAAE,GAAG,CAAC;QACpC,0EAA0E;SACzE,OAAO,CAAC,2BAA2B,EAAE,GAAG,CAAC;QAC1C,+EAA+E;SAC9E,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QAC5B,0EAA0E;SACzE,OAAO,CAAC,0BAA0B,EAAE,GAAG,CAAC;QACzC,4DAA4D;SAC3D,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;QAC7B,0CAA0C;SACzC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,sBAAsB,EAAE,GAAG,CAAC;QACrC,2EAA2E;QAC3E,6DAA6D;SAC5D,OAAO,CAAC,wEAAwE,EAAE,EAAE,CAAC;QACtF,uDAAuD;SACtD,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;IACV,OAAO,OAAO,IAAI,SAAS,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAW,WAAW,CAAC,OAAO,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cyanheads/biorxiv-mcp-server",
3
- "version": "0.1.17",
3
+ "version": "0.2.0",
4
4
  "mcpName": "io.github.cyanheads/biorxiv-mcp-server",
5
5
  "description": "Search and retrieve bioRxiv and medRxiv preprints — by DOI, date interval, or keyword — via MCP. STDIO or Streamable HTTP.",
6
6
  "type": "module",
@@ -88,6 +88,8 @@
88
88
  },
89
89
  "dependencies": {
90
90
  "@cyanheads/mcp-ts-core": "^0.10.14",
91
+ "defuddle": "^0.19.0",
92
+ "linkedom": "^0.18.12",
91
93
  "pino-pretty": "^13.1.3",
92
94
  "zod": "^4.4.3"
93
95
  },
package/server.json CHANGED
@@ -6,14 +6,14 @@
6
6
  "url": "https://github.com/cyanheads/biorxiv-mcp-server",
7
7
  "source": "github"
8
8
  },
9
- "version": "0.1.17",
9
+ "version": "0.2.0",
10
10
  "packages": [
11
11
  {
12
12
  "registryType": "npm",
13
13
  "registryBaseUrl": "https://registry.npmjs.org",
14
14
  "identifier": "@cyanheads/biorxiv-mcp-server",
15
15
  "runtimeHint": "bun",
16
- "version": "0.1.17",
16
+ "version": "0.2.0",
17
17
  "packageArguments": [
18
18
  {
19
19
  "type": "positional",
@@ -48,7 +48,7 @@
48
48
  "registryBaseUrl": "https://registry.npmjs.org",
49
49
  "identifier": "@cyanheads/biorxiv-mcp-server",
50
50
  "runtimeHint": "bun",
51
- "version": "0.1.17",
51
+ "version": "0.2.0",
52
52
  "packageArguments": [
53
53
  {
54
54
  "type": "positional",