@cyanheads/openalex-mcp-server 0.6.18 → 0.6.19

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 (5) hide show
  1. package/AGENTS.md +8 -3
  2. package/CLAUDE.md +8 -3
  3. package/README.md +1 -1
  4. package/package.json +3 -2
  5. package/server.json +3 -3
package/AGENTS.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # Agent Protocol
2
2
 
3
3
  **Server:** openalex-mcp-server
4
- **Version:** 0.6.18
5
- **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.16`
4
+ **Version:** 0.6.19
5
+ **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.21`
6
6
  **Engines:** Bun ≥1.3.0, Node ≥24.0.0
7
7
 
8
8
  > **Read the framework docs first:** `node_modules/@cyanheads/mcp-ts-core/CLAUDE.md` contains the full API reference — builders, Context, error codes, exports, patterns. This file covers server-specific conventions only.
@@ -253,7 +253,8 @@ Available skills:
253
253
  | `polish-docs-meta` | Finalize docs, README, metadata, and agent protocol for shipping |
254
254
  | `git-wrapup` | Land working-tree changes as a versioned commit + annotated tag — version bump, changelog, verify, tag. Local only. |
255
255
  | `release-and-publish` | Push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
256
- | `maintenance` | Investigate changelogs, adopt upstream changes, sync skills |
256
+ | `maintenance` | Investigate changelogs, adopt upstream changes, sync skills to agent dirs |
257
+ | `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
257
258
  | `report-issue-framework` | File a bug or feature request against `@cyanheads/mcp-ts-core` |
258
259
  | `report-issue-local` | File a bug or feature request against this server's own repo |
259
260
  | `api-auth` | Auth modes, scopes, JWT/OAuth |
@@ -267,6 +268,9 @@ Available skills:
267
268
  | `api-utils` | Formatting, parsing, security, pagination, scheduling, telemetry helpers |
268
269
  | `api-telemetry` | OTel catalog: spans, metrics, completion logs, env config, cardinality rules |
269
270
  | `api-workers` | Cloudflare Workers runtime |
271
+ | `api-mirror` | MirrorService: persistent local SQLite mirror of a bulk upstream dataset — Tier 3 opt-in |
272
+
273
+ **Chaining skills into pipelines.** When the user wants a multi-phase effort — build this server out, QA-and-fix the surface, update-and-ship — *and you can spawn sub-agents*, `skills/orchestrations/SKILL.md` sequences the task skills above into a gated pipeline with verification at each step. Read it to drive the run. Optional: skip it if you can't orchestrate sub-agents, and ignore it entirely if you were *spawned* as one — you've already been scoped to a single phase.
270
274
 
271
275
  When you complete a skill's checklist, check the boxes and add a completion timestamp at the end (e.g., `Completed: 2026-03-11`).
272
276
 
@@ -290,6 +294,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
290
294
  | `bun run start:http` | Production mode (HTTP, after `rebuild`) |
291
295
  | `bun run changelog:build` | Regenerate `CHANGELOG.md` from `changelog/*.md` |
292
296
  | `bun run changelog:check` | Verify `CHANGELOG.md` is in sync (used by devcheck) |
297
+ | `bun run release:github` | Create GitHub Release from the latest annotated tag (title `v<VERSION>: <subject>`, optional `.mcpb` attach) |
293
298
  | `bun run bundle` | Build and pack as `.mcpb` for one-click Claude Desktop install |
294
299
 
295
300
  ---
package/CLAUDE.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # Agent Protocol
2
2
 
3
3
  **Server:** openalex-mcp-server
4
- **Version:** 0.6.18
5
- **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.16`
4
+ **Version:** 0.6.19
5
+ **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.21`
6
6
  **Engines:** Bun ≥1.3.0, Node ≥24.0.0
7
7
 
8
8
  > **Read the framework docs first:** `node_modules/@cyanheads/mcp-ts-core/CLAUDE.md` contains the full API reference — builders, Context, error codes, exports, patterns. This file covers server-specific conventions only.
@@ -253,7 +253,8 @@ Available skills:
253
253
  | `polish-docs-meta` | Finalize docs, README, metadata, and agent protocol for shipping |
254
254
  | `git-wrapup` | Land working-tree changes as a versioned commit + annotated tag — version bump, changelog, verify, tag. Local only. |
255
255
  | `release-and-publish` | Push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
256
- | `maintenance` | Investigate changelogs, adopt upstream changes, sync skills |
256
+ | `maintenance` | Investigate changelogs, adopt upstream changes, sync skills to agent dirs |
257
+ | `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
257
258
  | `report-issue-framework` | File a bug or feature request against `@cyanheads/mcp-ts-core` |
258
259
  | `report-issue-local` | File a bug or feature request against this server's own repo |
259
260
  | `api-auth` | Auth modes, scopes, JWT/OAuth |
@@ -267,6 +268,9 @@ Available skills:
267
268
  | `api-utils` | Formatting, parsing, security, pagination, scheduling, telemetry helpers |
268
269
  | `api-telemetry` | OTel catalog: spans, metrics, completion logs, env config, cardinality rules |
269
270
  | `api-workers` | Cloudflare Workers runtime |
271
+ | `api-mirror` | MirrorService: persistent local SQLite mirror of a bulk upstream dataset — Tier 3 opt-in |
272
+
273
+ **Chaining skills into pipelines.** When the user wants a multi-phase effort — build this server out, QA-and-fix the surface, update-and-ship — *and you can spawn sub-agents*, `skills/orchestrations/SKILL.md` sequences the task skills above into a gated pipeline with verification at each step. Read it to drive the run. Optional: skip it if you can't orchestrate sub-agents, and ignore it entirely if you were *spawned* as one — you've already been scoped to a single phase.
270
274
 
271
275
  When you complete a skill's checklist, check the boxes and add a completion timestamp at the end (e.g., `Completed: 2026-03-11`).
272
276
 
@@ -290,6 +294,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
290
294
  | `bun run start:http` | Production mode (HTTP, after `rebuild`) |
291
295
  | `bun run changelog:build` | Regenerate `CHANGELOG.md` from `changelog/*.md` |
292
296
  | `bun run changelog:check` | Verify `CHANGELOG.md` is in sync (used by devcheck) |
297
+ | `bun run release:github` | Create GitHub Release from the latest annotated tag (title `v<VERSION>: <subject>`, optional `.mcpb` attach) |
293
298
  | `bun run bundle` | Build and pack as `.mcpb` for one-click Claude Desktop install |
294
299
 
295
300
  ---
package/README.md CHANGED
@@ -7,7 +7,7 @@
7
7
 
8
8
  <div align="center">
9
9
 
10
- [![Version](https://img.shields.io/badge/Version-0.6.18-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/openalex-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/openalex-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/openalex-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.0-blueviolet.svg?style=flat-square)](https://bun.sh/)
10
+ [![Version](https://img.shields.io/badge/Version-0.6.19-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/openalex-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/openalex-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/openalex-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.0-blueviolet.svg?style=flat-square)](https://bun.sh/)
11
11
 
12
12
  </div>
13
13
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cyanheads/openalex-mcp-server",
3
- "version": "0.6.18",
3
+ "version": "0.6.19",
4
4
  "description": "Access the OpenAlex academic research catalog - 270M+ publications through MCP. STDIO & Streamable HTTP.",
5
5
  "mcpName": "io.github.cyanheads/openalex-mcp-server",
6
6
  "type": "module",
@@ -26,6 +26,7 @@
26
26
  "changelog:build": "bun scripts/build-changelog.ts",
27
27
  "changelog:check": "bun scripts/build-changelog.ts --check",
28
28
  "test": "vitest run",
29
+ "release:github": "bun scripts/release-github.ts",
29
30
  "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
30
31
  "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
31
32
  "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
@@ -76,7 +77,7 @@
76
77
  "access": "public"
77
78
  },
78
79
  "dependencies": {
79
- "@cyanheads/mcp-ts-core": "^0.9.16",
80
+ "@cyanheads/mcp-ts-core": "^0.9.21",
80
81
  "pino-pretty": "^13.1.3",
81
82
  "zod": "^4.4.3"
82
83
  },
package/server.json CHANGED
@@ -6,7 +6,7 @@
6
6
  "url": "https://github.com/cyanheads/openalex-mcp-server",
7
7
  "source": "github"
8
8
  },
9
- "version": "0.6.18",
9
+ "version": "0.6.19",
10
10
  "remotes": [
11
11
  {
12
12
  "type": "streamable-http",
@@ -19,7 +19,7 @@
19
19
  "registryBaseUrl": "https://registry.npmjs.org",
20
20
  "identifier": "@cyanheads/openalex-mcp-server",
21
21
  "runtimeHint": "node",
22
- "version": "0.6.18",
22
+ "version": "0.6.19",
23
23
  "packageArguments": [
24
24
  {
25
25
  "type": "positional",
@@ -61,7 +61,7 @@
61
61
  "registryBaseUrl": "https://registry.npmjs.org",
62
62
  "identifier": "@cyanheads/openalex-mcp-server",
63
63
  "runtimeHint": "node",
64
- "version": "0.6.18",
64
+ "version": "0.6.19",
65
65
  "packageArguments": [
66
66
  {
67
67
  "type": "positional",