@cyanheads/wikipedia-mcp-server 0.1.6 → 0.1.7

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 (6) hide show
  1. package/AGENTS.md +10 -2
  2. package/CLAUDE.md +10 -2
  3. package/README.md +7 -7
  4. package/changelog/0.1.x/0.1.7.md +22 -0
  5. package/package.json +4 -3
  6. package/server.json +3 -3
package/AGENTS.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # Developer Protocol
2
2
 
3
3
  **Server:** wikipedia-mcp-server
4
- **Version:** 0.1.6
5
- **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.16`
4
+ **Version:** 0.1.7
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
  **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
8
8
  **Zod:** ^4.4.3
@@ -139,6 +139,10 @@ export function getServerConfig() {
139
139
 
140
140
  `parseEnvConfig` maps Zod schema paths → env var names so errors name the variable (`MY_API_KEY`) not the path (`apiKey`). Throws `ConfigurationError`, which the framework prints as a clean startup banner.
141
141
 
142
+ ### Server instructions
143
+
144
+ `createApp({ instructions })` — optional server-level orientation, sent to clients on every `initialize` as session-level context. Use it for deployment guidance (connection aliases, regional notes, scope hints) instead of repeating the same context across tool descriptions. Client adoption is uneven, but there's no downside when set.
145
+
142
146
  ---
143
147
 
144
148
  ## Context
@@ -276,10 +280,14 @@ Available skills:
276
280
  | `api-testing` | createMockContext, test patterns |
277
281
  | `api-utils` | Formatting, parsing, security, pagination, scheduling, telemetry helpers |
278
282
  | `api-telemetry` | OTel catalog: spans, metrics, completion logs, env config, cardinality rules |
283
+ | `api-mirror` | MirrorService: persistent, self-refreshing local SQLite mirror of a bulk upstream dataset |
279
284
  | `api-workers` | Cloudflare Workers runtime |
285
+ | `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
280
286
 
281
287
  When you complete a skill's checklist, check the boxes and add a completion timestamp at the end (e.g., `Completed: 2026-03-11`).
282
288
 
289
+ **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.
290
+
283
291
  ---
284
292
 
285
293
  ## Commands
package/CLAUDE.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # Developer Protocol
2
2
 
3
3
  **Server:** wikipedia-mcp-server
4
- **Version:** 0.1.6
5
- **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.16`
4
+ **Version:** 0.1.7
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
  **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
8
8
  **Zod:** ^4.4.3
@@ -139,6 +139,10 @@ export function getServerConfig() {
139
139
 
140
140
  `parseEnvConfig` maps Zod schema paths → env var names so errors name the variable (`MY_API_KEY`) not the path (`apiKey`). Throws `ConfigurationError`, which the framework prints as a clean startup banner.
141
141
 
142
+ ### Server instructions
143
+
144
+ `createApp({ instructions })` — optional server-level orientation, sent to clients on every `initialize` as session-level context. Use it for deployment guidance (connection aliases, regional notes, scope hints) instead of repeating the same context across tool descriptions. Client adoption is uneven, but there's no downside when set.
145
+
142
146
  ---
143
147
 
144
148
  ## Context
@@ -276,10 +280,14 @@ Available skills:
276
280
  | `api-testing` | createMockContext, test patterns |
277
281
  | `api-utils` | Formatting, parsing, security, pagination, scheduling, telemetry helpers |
278
282
  | `api-telemetry` | OTel catalog: spans, metrics, completion logs, env config, cardinality rules |
283
+ | `api-mirror` | MirrorService: persistent, self-refreshing local SQLite mirror of a bulk upstream dataset |
279
284
  | `api-workers` | Cloudflare Workers runtime |
285
+ | `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
280
286
 
281
287
  When you complete a skill's checklist, check the boxes and add a completion timestamp at the end (e.g., `Completed: 2026-03-11`).
282
288
 
289
+ **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.
290
+
283
291
  ---
284
292
 
285
293
  ## Commands
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.1.6-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/wikipedia-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/wikipedia-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/wikipedia-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.11-blueviolet.svg?style=flat-square)](https://bun.sh/)
10
+ [![Version](https://img.shields.io/badge/Version-0.1.7-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/wikipedia-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/wikipedia-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/wikipedia-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.11-blueviolet.svg?style=flat-square)](https://bun.sh/)
11
11
 
12
12
  </div>
13
13
 
@@ -125,10 +125,10 @@ Add the following to your MCP client configuration file.
125
125
  ```json
126
126
  {
127
127
  "mcpServers": {
128
- "wikipedia": {
128
+ "wikipedia-mcp-server": {
129
129
  "type": "stdio",
130
130
  "command": "bunx",
131
- "args": ["wikipedia-mcp-server@latest"],
131
+ "args": ["@cyanheads/wikipedia-mcp-server@latest"],
132
132
  "env": {
133
133
  "MCP_TRANSPORT_TYPE": "stdio",
134
134
  "MCP_LOG_LEVEL": "info"
@@ -143,10 +143,10 @@ Or with npx (no Bun required):
143
143
  ```json
144
144
  {
145
145
  "mcpServers": {
146
- "wikipedia": {
146
+ "wikipedia-mcp-server": {
147
147
  "type": "stdio",
148
148
  "command": "npx",
149
- "args": ["-y", "wikipedia-mcp-server@latest"],
149
+ "args": ["-y", "@cyanheads/wikipedia-mcp-server@latest"],
150
150
  "env": {
151
151
  "MCP_TRANSPORT_TYPE": "stdio",
152
152
  "MCP_LOG_LEVEL": "info"
@@ -161,7 +161,7 @@ Or with Docker:
161
161
  ```json
162
162
  {
163
163
  "mcpServers": {
164
- "wikipedia": {
164
+ "wikipedia-mcp-server": {
165
165
  "type": "stdio",
166
166
  "command": "docker",
167
167
  "args": [
@@ -217,7 +217,7 @@ cp .env.example .env
217
217
 
218
218
  | Variable | Description | Default |
219
219
  |:---------|:------------|:--------|
220
- | `WIKIPEDIA_USER_AGENT` | User-Agent header sent with every Wikimedia API request. Customize for your deployment. | `wikipedia-mcp-server/0.1.6 (https://github.com/cyanheads/wikipedia-mcp-server)` |
220
+ | `WIKIPEDIA_USER_AGENT` | User-Agent header sent with every Wikimedia API request. Customize for your deployment. | `wikipedia-mcp-server/0.1.7 (https://github.com/cyanheads/wikipedia-mcp-server)` |
221
221
  | `WIKIPEDIA_BASE_URL` | Base Wikipedia URL. Language selection is per-call — not a global language setting. | `https://en.wikipedia.org` |
222
222
  | `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http`. | `stdio` |
223
223
  | `MCP_HTTP_PORT` | Port for HTTP server. | `3010` |
package/changelog/0.1.x/0.1.7.md ADDED
@@ -0,0 +1,22 @@
1
+ ---
2
+ summary: "mcp-ts-core ^0.9.16 → ^0.9.21: per-request log context fix, fetchWithTimeout secret-stripping, withRetry fail-fast on non-retryable errors; skill sync (api-mirror, orchestrations, 8 updated); release:github script; README client-config key renamed to package name"
3
+ breaking: false
4
+ security: false
5
+ ---
6
+
7
+ # 0.1.7 — 2026-06-02
8
+
9
+ ## Changed
10
+
11
+ - **`@cyanheads/mcp-ts-core`** `^0.9.16 → ^0.9.21` — picks up three framework fixes:
12
+ - HTTP transport per-request log context: per-request logs and traces now carry fresh request + trace/span IDs instead of the frozen boot context.
13
+ - `fetchWithTimeout` strips query-string secrets (e.g. `?api_key=`) from error messages and logs.
14
+ - `withRetry` fails fast on non-retryable errors; `ctx.fail` auto-populates the `retryable` flag.
15
+ - **README client-config** — server key in install snippets renamed from `wikipedia` to `wikipedia-mcp-server`; `bunx`/`npx` args updated to the scoped package name `@cyanheads/wikipedia-mcp-server`.
16
+ - **Skills synced** — `api-context`, `api-linter`, `api-utils`, `api-canvas`, `add-tool`, `add-service`, `design-mcp-server`, `release-and-publish` updated from framework `0.9.21`; `api-mirror` and `orchestrations` added.
17
+ - **`scripts/release-github.ts`** added — `release:github` script for one-command GitHub Release creation.
18
+
19
+ ## Dependencies
20
+
21
+ - `@cyanheads/mcp-ts-core` `^0.9.16 → ^0.9.21`
22
+ - `vitest` `^4.1.7 → ^4.1.8`
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cyanheads/wikipedia-mcp-server",
3
- "version": "0.1.6",
3
+ "version": "0.1.7",
4
4
  "description": "Search Wikipedia articles, read summaries and full text, target sections, find nearby pages, and list language editions via MCP. STDIO or Streamable HTTP.",
5
5
  "mcpName": "io.github.cyanheads/wikipedia-mcp-server",
6
6
  "type": "module",
@@ -35,6 +35,7 @@
35
35
  "changelog:build": "bun run scripts/build-changelog.ts",
36
36
  "changelog:check": "bun run scripts/build-changelog.ts --check",
37
37
  "test": "bunx vitest run",
38
+ "release:github": "bun run scripts/release-github.ts",
38
39
  "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
39
40
  "start:stdio": "MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
40
41
  "start:http": "MCP_TRANSPORT_TYPE=http bun ./dist/index.js"
@@ -79,7 +80,7 @@
79
80
  "access": "public"
80
81
  },
81
82
  "dependencies": {
82
- "@cyanheads/mcp-ts-core": "^0.9.16",
83
+ "@cyanheads/mcp-ts-core": "^0.9.21",
83
84
  "pino-pretty": "^13.1.3",
84
85
  "wtf_wikipedia": "^10.4.2",
85
86
  "zod": "^4.4.3"
@@ -91,6 +92,6 @@
91
92
  "ignore": "^7.0.5",
92
93
  "tsc-alias": "^1.8.17",
93
94
  "typescript": "^6.0.3",
94
- "vitest": "^4.1.7"
95
+ "vitest": "^4.1.8"
95
96
  }
96
97
  }
package/server.json CHANGED
@@ -6,14 +6,14 @@
6
6
  "url": "https://github.com/cyanheads/wikipedia-mcp-server",
7
7
  "source": "github"
8
8
  },
9
- "version": "0.1.6",
9
+ "version": "0.1.7",
10
10
  "packages": [
11
11
  {
12
12
  "registryType": "npm",
13
13
  "registryBaseUrl": "https://registry.npmjs.org",
14
14
  "identifier": "@cyanheads/wikipedia-mcp-server",
15
15
  "runtimeHint": "bun",
16
- "version": "0.1.6",
16
+ "version": "0.1.7",
17
17
  "packageArguments": [
18
18
  {
19
19
  "type": "positional",
@@ -42,7 +42,7 @@
42
42
  "registryBaseUrl": "https://registry.npmjs.org",
43
43
  "identifier": "@cyanheads/wikipedia-mcp-server",
44
44
  "runtimeHint": "bun",
45
- "version": "0.1.6",
45
+ "version": "0.1.7",
46
46
  "packageArguments": [
47
47
  {
48
48
  "type": "positional",