@cyanheads/cern-inspire-mcp-server 0.1.2 → 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 (66) hide show
  1. package/AGENTS.md +39 -39
  2. package/CLAUDE.md +39 -39
  3. package/Dockerfile +8 -3
  4. package/README.md +59 -115
  5. package/changelog/0.1.x/0.1.3.md +34 -0
  6. package/changelog/0.2.x/0.2.0.md +35 -0
  7. package/dist/index.js +2 -1
  8. package/dist/index.js.map +1 -1
  9. package/dist/mcp-server/resources/definitions/index.d.ts +10 -0
  10. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
  11. package/dist/mcp-server/resources/definitions/inspire-literature.resource.d.ts +10 -0
  12. package/dist/mcp-server/resources/definitions/inspire-literature.resource.d.ts.map +1 -1
  13. package/dist/mcp-server/resources/definitions/inspire-literature.resource.js +1 -1
  14. package/dist/mcp-server/resources/definitions/inspire-literature.resource.js.map +1 -1
  15. package/dist/mcp-server/tools/definitions/export-citations.tool.d.ts +48 -4
  16. package/dist/mcp-server/tools/definitions/export-citations.tool.d.ts.map +1 -1
  17. package/dist/mcp-server/tools/definitions/export-citations.tool.js +51 -25
  18. package/dist/mcp-server/tools/definitions/export-citations.tool.js.map +1 -1
  19. package/dist/mcp-server/tools/definitions/get-citation-summary.tool.d.ts +2 -2
  20. package/dist/mcp-server/tools/definitions/get-citation-summary.tool.d.ts.map +1 -1
  21. package/dist/mcp-server/tools/definitions/get-citation-summary.tool.js +10 -7
  22. package/dist/mcp-server/tools/definitions/get-citation-summary.tool.js.map +1 -1
  23. package/dist/mcp-server/tools/definitions/get-paper.tool.d.ts +22 -1
  24. package/dist/mcp-server/tools/definitions/get-paper.tool.d.ts.map +1 -1
  25. package/dist/mcp-server/tools/definitions/get-paper.tool.js +79 -23
  26. package/dist/mcp-server/tools/definitions/get-paper.tool.js.map +1 -1
  27. package/dist/mcp-server/tools/definitions/index.d.ts +146 -91
  28. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  29. package/dist/mcp-server/tools/definitions/list-reference.tool.d.ts.map +1 -1
  30. package/dist/mcp-server/tools/definitions/list-reference.tool.js +6 -1
  31. package/dist/mcp-server/tools/definitions/list-reference.tool.js.map +1 -1
  32. package/dist/mcp-server/tools/definitions/search-authors.tool.d.ts.map +1 -1
  33. package/dist/mcp-server/tools/definitions/search-authors.tool.js +7 -3
  34. package/dist/mcp-server/tools/definitions/search-authors.tool.js.map +1 -1
  35. package/dist/mcp-server/tools/definitions/search-experiments.tool.d.ts.map +1 -1
  36. package/dist/mcp-server/tools/definitions/search-experiments.tool.js +17 -10
  37. package/dist/mcp-server/tools/definitions/search-experiments.tool.js.map +1 -1
  38. package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts +1 -1
  39. package/dist/mcp-server/tools/definitions/search-hepdata.tool.d.ts.map +1 -1
  40. package/dist/mcp-server/tools/definitions/search-hepdata.tool.js +8 -6
  41. package/dist/mcp-server/tools/definitions/search-hepdata.tool.js.map +1 -1
  42. package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts +3 -3
  43. package/dist/mcp-server/tools/definitions/search-literature.tool.d.ts.map +1 -1
  44. package/dist/mcp-server/tools/definitions/search-literature.tool.js +16 -11
  45. package/dist/mcp-server/tools/definitions/search-literature.tool.js.map +1 -1
  46. package/dist/mcp-server/tools/inputs.d.ts +6 -0
  47. package/dist/mcp-server/tools/inputs.d.ts.map +1 -1
  48. package/dist/mcp-server/tools/inputs.js +71 -0
  49. package/dist/mcp-server/tools/inputs.js.map +1 -1
  50. package/dist/services/inspire/inspire-service.d.ts +11 -3
  51. package/dist/services/inspire/inspire-service.d.ts.map +1 -1
  52. package/dist/services/inspire/inspire-service.js +58 -37
  53. package/dist/services/inspire/inspire-service.js.map +1 -1
  54. package/dist/services/inspire/normalize.d.ts +3 -2
  55. package/dist/services/inspire/normalize.d.ts.map +1 -1
  56. package/dist/services/inspire/normalize.js +23 -3
  57. package/dist/services/inspire/normalize.js.map +1 -1
  58. package/dist/services/inspire/types.d.ts +27 -7
  59. package/dist/services/inspire/types.d.ts.map +1 -1
  60. package/dist/utils/render.d.ts +6 -4
  61. package/dist/utils/render.d.ts.map +1 -1
  62. package/dist/utils/render.js +8 -4
  63. package/dist/utils/render.js.map +1 -1
  64. package/package.json +12 -11
  65. package/server.json +10 -24
  66. package/skills/cern-inspire-guide/SKILL.md +43 -0
@@ -5,13 +5,13 @@
5
5
  * strikethrough, HTML, control, and invisible format characters neutralized;
6
6
  * text that opens a line or list item cannot open a block; free text is
7
7
  * blockquoted; citation entries are fenced. A caller's own text echoed in a
8
- * notice or error message goes through `callerEcho()`, and an identifier value
8
+ * notice goes through `callerEcho()`, and an identifier value
9
9
  * (DOI, texkey, BAI, …) through `identifier()`; both leave `*`, `_`, `~`, `>`,
10
10
  * and a `<` that opens no markup as written so the text copies back. The domain
11
11
  * fields of `structuredContent` never pass through here: they hold what the
12
12
  * service normalized (titles and abstracts converted from publisher markup to
13
13
  * text, other strings as decoded).
14
- * The service also uses `inline()` for upstream text it puts in an error message.
14
+ * Error messages use `errorText()` for control hygiene; the framework escapes their Markdown.
15
15
  * @module utils/render
16
16
  */
17
17
  /**
@@ -21,9 +21,11 @@
21
21
  * escaped, `<` `>` become entities.
22
22
  */
23
23
  export declare function inline(text: string): string;
24
+ /** One-line error text with control/format characters stripped; Markdown escaping belongs to the framework error boundary. */
25
+ export declare function errorText(text: string): string;
24
26
  /**
25
- * A caller's own query, author, or paper identifier echoed in a notice or error
26
- * message. Those strings ride `structuredContent` as well as `content[]`, and a
27
+ * A caller's own query, author, or paper identifier echoed in a notice.
28
+ * Those strings ride `structuredContent` as well as `content[]`, and a
27
29
  * caller may send the echo back as its next query, so INSPIRE's `*` wildcard,
28
30
  * `_`, `~`, and the `>` of `date > 2015` or `P P --> TOP TOPBAR X` are left as
29
31
  * written. Line breaks become one space, control and format characters are
@@ -1 +1 @@
1
- {"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/utils/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAuFH;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,sGAAsG;AACtG,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,mGAAmG;AACnG,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK1C;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAYD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGpD"}
1
+ {"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/utils/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAuFH;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,8HAA8H;AAC9H,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,sGAAsG;AACtG,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,mGAAmG;AACnG,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK1C;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAYD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGpD"}
@@ -5,13 +5,13 @@
5
5
  * strikethrough, HTML, control, and invisible format characters neutralized;
6
6
  * text that opens a line or list item cannot open a block; free text is
7
7
  * blockquoted; citation entries are fenced. A caller's own text echoed in a
8
- * notice or error message goes through `callerEcho()`, and an identifier value
8
+ * notice goes through `callerEcho()`, and an identifier value
9
9
  * (DOI, texkey, BAI, …) through `identifier()`; both leave `*`, `_`, `~`, `>`,
10
10
  * and a `<` that opens no markup as written so the text copies back. The domain
11
11
  * fields of `structuredContent` never pass through here: they hold what the
12
12
  * service normalized (titles and abstracts converted from publisher markup to
13
13
  * text, other strings as decoded).
14
- * The service also uses `inline()` for upstream text it puts in an error message.
14
+ * Error messages use `errorText()` for control hygiene; the framework escapes their Markdown.
15
15
  * @module utils/render
16
16
  */
17
17
  /**
@@ -88,9 +88,13 @@ function neutralize(text) {
88
88
  export function inline(text) {
89
89
  return neutralize(text.replace(LINE_BREAK, ' '));
90
90
  }
91
+ /** One-line error text with control/format characters stripped; Markdown escaping belongs to the framework error boundary. */
92
+ export function errorText(text) {
93
+ return text.replace(LINE_BREAK, ' ').replace(STRIPPED, '').replace(/\t/g, ' ');
94
+ }
91
95
  /**
92
- * A caller's own query, author, or paper identifier echoed in a notice or error
93
- * message. Those strings ride `structuredContent` as well as `content[]`, and a
96
+ * A caller's own query, author, or paper identifier echoed in a notice.
97
+ * Those strings ride `structuredContent` as well as `content[]`, and a
94
98
  * caller may send the echo back as its next query, so INSPIRE's `*` wildcard,
95
99
  * `_`, `~`, and the `>` of `date > 2015` or `P P --> TOP TOPBAR X` are left as
96
100
  * written. Line breaks become one space, control and format characters are
@@ -1 +1 @@
1
- {"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/utils/render.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/utils/render.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cyanheads/cern-inspire-mcp-server",
3
- "version": "0.1.2",
3
+ "version": "0.2.0",
4
4
  "mcpName": "io.github.cyanheads/cern-inspire-mcp-server",
5
5
  "description": "Search INSPIRE-HEP papers, authors, experiments, HEPData records; get citation metrics and BibTeX via MCP. STDIO or Streamable HTTP.",
6
6
  "author": "Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)",
@@ -21,6 +21,7 @@
21
21
  "cern-inspire-mcp-server": "dist/index.js"
22
22
  },
23
23
  "files": [
24
+ "skills/",
24
25
  "changelog/",
25
26
  "dist/",
26
27
  "!dist/*.mcpb",
@@ -84,7 +85,7 @@
84
85
  "url": "https://github.com/cyanheads/cern-inspire-mcp-server/issues"
85
86
  },
86
87
  "license": "Apache-2.0",
87
- "packageManager": "bun@1.4.2",
88
+ "packageManager": "bun@1.4.4",
88
89
  "engines": {
89
90
  "bun": ">=1.4.0",
90
91
  "node": ">=24.0.0"
@@ -93,20 +94,20 @@
93
94
  "access": "public"
94
95
  },
95
96
  "dependencies": {
96
- "@cyanheads/mcp-ts-core": "^0.13.10",
97
- "pino-pretty": "^13.1.3",
98
- "zod": "^4.6.5"
97
+ "@cyanheads/mcp-ts-core": "^0.13.18",
98
+ "pino-pretty": "^13.2.0",
99
+ "zod": "^4.6.7"
99
100
  },
100
101
  "devDependencies": {
101
- "@biomejs/biome": "2.5.14",
102
+ "@biomejs/biome": "2.6.3",
102
103
  "@socketsecurity/bun-security-scanner": "^1.1.3",
103
- "@types/node": "26.6.3",
104
- "@vitest/coverage-istanbul": "5.0.2",
104
+ "@types/node": "26.6.5",
105
+ "@vitest/coverage-istanbul": "5.0.5",
105
106
  "depcheck": "^1.4.7",
106
107
  "fast-check": "^4.10.2",
107
- "ignore": "^7.0.10",
108
- "tsc-alias": "^1.9.5",
108
+ "ignore": "^7.0.14",
109
+ "tsc-alias": "^1.9.9",
109
110
  "typescript": "^7.0.2",
110
- "vitest": "^5.0.2"
111
+ "vitest": "^5.0.5"
111
112
  }
112
113
  }
package/server.json CHANGED
@@ -7,7 +7,7 @@
7
7
  "url": "https://github.com/cyanheads/cern-inspire-mcp-server",
8
8
  "source": "github"
9
9
  },
10
- "version": "0.1.2",
10
+ "version": "0.2.0",
11
11
  "remotes": [
12
12
  {
13
13
  "type": "streamable-http",
@@ -19,18 +19,8 @@
19
19
  "registryType": "npm",
20
20
  "registryBaseUrl": "https://registry.npmjs.org",
21
21
  "identifier": "@cyanheads/cern-inspire-mcp-server",
22
- "runtimeHint": "node",
23
- "version": "0.1.2",
24
- "packageArguments": [
25
- {
26
- "type": "positional",
27
- "value": "run"
28
- },
29
- {
30
- "type": "positional",
31
- "value": "start:stdio"
32
- }
33
- ],
22
+ "runtimeHint": "npx",
23
+ "version": "0.2.0",
34
24
  "environmentVariables": [
35
25
  {
36
26
  "name": "MCP_LOG_LEVEL",
@@ -48,19 +38,15 @@
48
38
  "registryType": "npm",
49
39
  "registryBaseUrl": "https://registry.npmjs.org",
50
40
  "identifier": "@cyanheads/cern-inspire-mcp-server",
51
- "runtimeHint": "node",
52
- "version": "0.1.2",
53
- "packageArguments": [
41
+ "runtimeHint": "npx",
42
+ "version": "0.2.0",
43
+ "environmentVariables": [
54
44
  {
55
- "type": "positional",
56
- "value": "run"
45
+ "name": "MCP_TRANSPORT_TYPE",
46
+ "description": "Selects the HTTP transport.",
47
+ "format": "string",
48
+ "value": "http"
57
49
  },
58
- {
59
- "type": "positional",
60
- "value": "start:http"
61
- }
62
- ],
63
- "environmentVariables": [
64
50
  {
65
51
  "name": "MCP_HTTP_HOST",
66
52
  "description": "The hostname for the HTTP server.",
@@ -0,0 +1,43 @@
1
+ ---
2
+ name: cern-inspire-guide
3
+ description: Use cern_inspire_* tools for HEP literature research, author or institution citation analysis, citation-network exploration, bibliography assembly, and finding numerical-data publications. Resolve identities, verify query scope, and distinguish publication-year filters from citation-year series before drawing conclusions.
4
+ license: Apache-2.0
5
+ metadata:
6
+ author: "cyanheads"
7
+ version: "1.0"
8
+ ---
9
+
10
+ ## Scope
11
+
12
+ INSPIRE-HEP covers high-energy-physics literature, author profiles, experiments, and publication-level HEPData records through a keyless API. Numerical table values require the returned HEPData record page; this server cannot read them.
13
+
14
+ ## Identifiers
15
+
16
+ Recids belong to separate collections. Keep each ID attached to its source: literature recids from `cern_inspire_search_literature` or `cern_inspire_get_paper`; author recids and BAIs from `cern_inspire_search_authors`; experiment queries from `cern_inspire_search_experiments`; institution recids from author positions or experiment institutions. A numeric paper ID is not an author or institution ID.
17
+
18
+ Reuse returned `literatureQuery` values for author and experiment cohorts. For institutions, build `affid:N` only from a returned institution recid. A HEPData record DOI identifies data, not the associated literature record; follow returned paper recids for the publication.
19
+
20
+ ## Gates
21
+
22
+ 1. Resolve a person's name before attributing papers or metrics. Compare candidate profiles' affiliations, categories, and identifiers; do not select the first namesake by rank. A missing ORCID match can mean the profile has no linked ORCID: search by name before concluding the person is absent.
23
+ 2. Inspect representative literature matches before summarizing or exporting a cohort. Check the effective query and applied filters. An unexpectedly broad or empty result can be malformed syntax despite a successful response; consult `cern_inspire_list_reference` before treating it as evidence. Multiple document types or subjects intersect; they do not form a union.
24
+ 3. Resolve an old paper ID with `cern_inspire_get_paper` before concluding a query has no matching paper, citations, or references. Merged IDs can match nothing in queries; use the surviving recid returned by the dossier.
25
+ 4. Distinguish papers published in a year range from citations received in that range. Summary year filters select the papers and leave out the yearly citation series. For citation-year questions, obtain the full series and select its returned year rows. An omitted series is unavailable, not zero; it counts citations over all matched records and need not sum to the citeable-paper total.
26
+ 5. Establish coverage before claiming a complete bibliography or literature set. Follow returned continuation signals and notices; do not keep probing until a page is empty. Literature search reports `totalCount` and `hasMore`; export uses `nextPage`, `truncated`, and notices, with no total count. Beyond the 10,000-result window, narrow the query and report the remaining coverage limit. Pages reflect a changing index: deduplication removes repeats but cannot prove that no papers were skipped.
27
+ 6. Distinguish an unsuccessful HEPData availability lookup from a negative result. Publication-level data metadata does not establish any particular table's contents or values.
28
+
29
+ ## Core chain
30
+
31
+ Resolve the paper, person, or experiment → inspect the selected literature cohort → retrieve dossiers, summarize citations, or export the verified set. Keep the same query and filters when carrying a cohort between tools.
32
+
33
+ ## Workflows
34
+
35
+ **Author or institution analysis.** Resolve a person with `cern_inspire_search_authors`, inspect their returned literature query, then use `cern_inspire_get_citation_summary` for the selected profile. For an institution, use a linked institution recid with `affid:N`; this includes linked author/supervisor affiliations, thesis institutions, and record-level affiliations, so describe that scope rather than calling it an employee-only publication count. Compare like scopes: all citeable versus published, the same publication years, and the same self-citation treatment.
36
+
37
+ **Citation networks and bibliographies.** Start with `cern_inspire_get_paper` and reuse its ready-made queries for citing papers or references; the INSPIRE operators are easy to reverse (`refersto` finds citing papers, `citedby` finds references). Inspect the set with `cern_inspire_search_literature`, then call `cern_inspire_export_citations`. For a curated shortlist, export the selected literature recids joined with `or` instead of rerunning the broad discovery query. Keep query, filters, sort, and page size fixed during pagination, and preserve any coverage notices with the bibliography.
38
+
39
+ **Measurements and numerical data.** When the paper is unknown, use `cern_inspire_search_hepdata` with the process, observable, energy, or collaboration. Follow its paper recids to `cern_inspire_get_paper` for publication context. When starting from an experiment, resolve it with `cern_inspire_search_experiments` and reuse its literature query to find the relevant paper. Return the HEPData record page for reading or downloading tables and its record DOI for citing the data; do not infer numerical results from keywords or table counts.
40
+
41
+ ## References
42
+
43
+ Call `cern_inspire_list_reference` for INSPIRE query syntax, identifier forms, document types, subjects, citation buckets, and HEPData version/DOI conventions. In particular, literature queries require unversioned arXiv IDs, and ORCIDs resolve through author tools rather than literature queries.