@cyanheads/wikidata-mcp-server 0.1.3 → 0.1.5

package/CLAUDE.md

@@ -1,7 +1,7 @@
 # Developer Protocol
 
 **Server:** @cyanheads/wikidata-mcp-server
-**Version:** 0.1.1
+**Version:** 0.1.5
 **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.7`
 **Engines:** Bun ≥1.3.0, Node ≥24.0.0
 **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0

package/Dockerfile

@@ -41,7 +41,7 @@ ENV NODE_ENV=production
 
 # OCI image metadata (https://github.com/opencontainers/image-spec/blob/main/annotations.md)
 LABEL org.opencontainers.image.title="@cyanheads/wikidata-mcp-server"
-LABEL org.opencontainers.image.description="Search and fetch Wikidata entities, execute SPARQL queries, and resolve external identifiers."
+LABEL org.opencontainers.image.description="Search and fetch Wikidata entities, execute SPARQL queries, and resolve external identifiers via MCP. STDIO or Streamable HTTP."
 LABEL org.opencontainers.image.licenses="Apache-2.0"
 LABEL org.opencontainers.image.source="https://github.com/cyanheads/wikidata-mcp-server"
 

package/README.md

@@ -7,7 +7,7 @@
 
 <div align="center">
 
-[![Version](https://img.shields.io/badge/Version-0.1.3-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![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/wikidata-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/wikidata-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/)
+[![Version](https://img.shields.io/badge/Version-0.1.5-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/wikidata-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/wikidata-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/wikidata-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.2-blueviolet.svg?style=flat-square)](https://bun.sh/)
 
 </div>
 
@@ -19,6 +19,12 @@
 
 </div>
 
+<div align="center">
+
+**Public Hosted Server:** [https://wikidata.caseyjhand.com/mcp](https://wikidata.caseyjhand.com/mcp)
+
+</div>
+
 ---
 
 ## Tools

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyanheads/wikidata-mcp-server",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "mcpName": "io.github.cyanheads/wikidata-mcp-server",
   "description": "Search and fetch Wikidata entities, execute SPARQL queries, and resolve external identifiers via MCP. STDIO or Streamable HTTP.",
   "type": "module",
@@ -9,34 +9,24 @@
   "bin": {
     "wikidata-mcp-server": "dist/index.js"
   },
-  "files": [
-    "changelog/",
-    "dist/",
-    "README.md",
-    "LICENSE",
-    "CLAUDE.md",
-    "AGENTS.md",
-    "Dockerfile",
-    "server.json"
-  ],
+  "files": ["dist/", "README.md", "LICENSE", "CLAUDE.md", "Dockerfile", "server.json"],
   "scripts": {
-    "build": "tsx scripts/build.ts",
-    "rebuild": "tsx scripts/clean.ts && tsx scripts/build.ts",
-    "clean": "tsx scripts/clean.ts",
-    "devcheck": "tsx scripts/devcheck.ts",
+    "build": "bun run scripts/build.ts",
+    "rebuild": "bun run scripts/clean.ts && bun run build",
+    "clean": "bun run scripts/clean.ts",
+    "devcheck": "bun run scripts/devcheck.ts",
     "audit:refresh": "rm -f bun.lock && bun install && bun audit",
-    "tree": "tsx scripts/tree.ts",
-    "list-skills": "tsx scripts/list-skills.ts",
-    "format": "biome check --write --unsafe .",
-    "lint:mcp": "tsx scripts/lint-mcp.ts",
-    "lint:packaging": "tsx scripts/lint-packaging.ts",
-    "bundle": "npm run build && npx -y @anthropic-ai/mcpb pack . dist/wikidata-mcp-server.mcpb",
-    "changelog:build": "tsx scripts/build-changelog.ts",
-    "changelog:check": "tsx scripts/build-changelog.ts --check",
-    "test": "vitest run",
-    "start": "node dist/index.js",
-    "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
-    "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js",
+    "tree": "bun run scripts/tree.ts",
+    "list-skills": "bun run scripts/list-skills.ts",
+    "format": "biome check --write --unsafe",
+    "lint:mcp": "bun run scripts/lint-mcp.ts",
+    "lint:packaging": "bun run scripts/lint-packaging.ts",
+    "bundle": "bun run build && npx -y @anthropic-ai/mcpb pack . dist/wikidata-mcp-server.mcpb",
+    "changelog:build": "bun run scripts/build-changelog.ts",
+    "changelog:check": "bun run scripts/build-changelog.ts --check",
+    "test": "bunx vitest run",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http bun ./dist/index.js",
     "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish"
   },
   "keywords": [
@@ -47,6 +37,7 @@
     "bun",
     "stdio",
     "streamable-http",
+    "ai-agent",
     "wikidata",
     "sparql",
     "knowledge-graph",
@@ -75,7 +66,7 @@
   "license": "Apache-2.0",
   "packageManager": "bun@1.3.2",
   "engines": {
-    "bun": ">=1.3.0",
+    "bun": ">=1.3.2",
     "node": ">=24.0.0"
   },
   "publishConfig": {

package/server.json

@@ -6,14 +6,20 @@
     "url": "https://github.com/cyanheads/wikidata-mcp-server",
     "source": "github"
   },
-  "version": "0.1.3",
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://wikidata.caseyjhand.com/mcp"
+    }
+  ],
+  "version": "0.1.5",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/wikidata-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.1.3",
+      "version": "0.1.5",
       "packageArguments": [
         {
           "type": "positional",
@@ -63,7 +69,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/wikidata-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.1.3",
+      "version": "0.1.5",
       "packageArguments": [
         {
           "type": "positional",

package/changelog/0.1.x/0.1.0.md

@@ -1,20 +0,0 @@
----
-summary: "Initial release — 7 tools covering entity search, fetch, statements, labels, sitelinks, SPARQL, and external ID resolution"
-breaking: false
-security: false
----
-
-# 0.1.0 — 2026-05-23
-
-## Added
-
-- `wikidata_search_entities` — search items or properties by text query with pagination and language support
-- `wikidata_get_entity` — fetch a full entity (item or property) by QID or PID with field and language filtering
-- `wikidata_get_statements` — fetch normalized property statements with qualifier and reference detail; resolves wikibase-item value QIDs to labels by default
-- `wikidata_get_labels` — batch-resolve up to 50 QIDs/PIDs to human-readable labels and descriptions via wbgetentities
-- `wikidata_get_sitelinks` — fetch Wikipedia and Wikimedia sitelinks for a Wikidata item with optional site filtering and wikis-only mode
-- `wikidata_sparql_query` — execute SPARQL SELECT queries against the Wikidata Query Service; auto-injects standard prefixes and the wikibase:label SERVICE
-- `wikidata_resolve_external_id` — look up a Wikidata entity by DOI (P356), PubMed ID (P698), ORCID (P496), OpenAlex ID (P10283), or any external identifier property; normalizes DOIs, PMIDs, and ORCIDs automatically
-- `wikidata://entity/{id}` resource — compact markdown entity summary by QID or PID
-- `WikidataRestService` — client for the Wikidata REST API v1 and MediaWiki wbgetentities API with retry, timeout, and rate-limit handling
-- `WikidataSparqlService` — client for the Wikidata SPARQL endpoint with query preparation, prefix injection, and label SERVICE injection

package/changelog/0.1.x/0.1.1.md

@@ -1,20 +0,0 @@
----
-summary: "First real release — Wikidata knowledge graph MCP server with 7 tools for entity search/fetch, SPARQL queries, batch label resolution, and external ID lookup (DOI, PMID, ORCID, OpenAlex, IMDb)"
-breaking: false
-security: false
----
-
-# 0.1.1 — 2026-05-23
-
-## Added
-
-- `wikidata_search_entities` — search items or properties by text query with pagination and language support
-- `wikidata_get_entity` — fetch a full entity by QID or PID with field and language filtering
-- `wikidata_get_statements` — fetch normalized property statements with qualifier and reference detail; resolves wikibase-item value QIDs to labels by default
-- `wikidata_get_labels` — batch-resolve up to 50 QIDs/PIDs to labels and descriptions via `wbgetentities`
-- `wikidata_get_sitelinks` — fetch Wikipedia and Wikimedia sitelinks with optional site filtering and wikis-only mode
-- `wikidata_sparql_query` — execute SPARQL SELECT queries against the Wikidata Query Service; auto-injects standard prefixes and the `wikibase:label` SERVICE
-- `wikidata_resolve_external_id` — look up Wikidata entities by DOI (P356), PubMed ID (P698), ORCID (P496), OpenAlex ID (P10283), IMDb ID (P345), or any external identifier property; normalizes DOI/PMID/ORCID formats automatically
-- `wikidata://entity/{id}` resource — compact markdown entity summary by QID or PID
-- `WikidataRestService` — Wikidata REST API v1 + MediaWiki `wbgetentities` client with retry, timeout, and rate-limit handling
-- `WikidataSparqlService` — SPARQL endpoint client with query preparation, prefix injection, and label SERVICE injection

package/changelog/0.1.x/0.1.2.md

@@ -1,20 +0,0 @@
----
-summary: "Label type fixes, statusCode error path, resource output shape — correct the REST API type layer and not_found detection"
-breaking: false
-security: false
----
-
-# 0.1.2 — 2026-05-24
-
-## Fixed
-
-- **Label/description types** — REST API v1 returns plain strings, not nested `{ language, value }` objects. `LocalizedString` type removed; `LocalizedStringMap` and `AliasMap` now use `string` and `string[]` respectively. `flattenLabelMap`/`flattenAliasMap` helpers dropped; `get-entity` handler returns the correct shape without flattening.
-- **404 detection** — REST API error shape uses `statusCode`, not `status`. Fixed in `entity.resource`, `wikidata_get_entity`, and `wikidata_get_statements` — entities that don't exist now correctly throw `entity_not_found` / `notFound` instead of re-throwing the raw error.
-- **Statement label extraction** — `entity.resource` and `wikidata_get_statements` now handle both string and `{ id }` content values when extracting QIDs from `wikibase-item` statement values.
-- **Resource output shape** — `entity.resource` handler returns the markdown string directly; the erroneous `output: z.object({ content })` wrapper is removed.
-
-## Changed
-
-- **Metadata** — `package.json`: `mcpName`, `author`, `bugs`, `homepage`, `funding`, `packageManager` fields added; `bin` key normalized; repository URL uses `git+` prefix. `server.json`: name updated to `io.github.cyanheads/wikidata-mcp-server`, `runtimeHint` → `bun` on both packages. `Dockerfile`: OCI `title`, `description`, and `source` labels populated. `manifest.json`: `repository`, `homepage`, `license` fields added.
-- `bunfig.toml` added with Bun install and run configuration.
-- Docker install snippet added to README.

package/changelog/0.1.x/0.1.3.md

@@ -1,11 +0,0 @@
----
-summary: "Sync tagline across all surfaces — adds 'and' before 'resolve external identifiers'"
-breaking: false
-security: false
----
-
-# 0.1.3 — 2026-05-23
-
-## Changed
-
-- **Tagline** — all description surfaces (`package.json`, `server.json`, `manifest.json`, `Dockerfile`, README header, GitHub repo) now read: "Search and fetch Wikidata entities, execute SPARQL queries, and resolve external identifiers via MCP. STDIO or Streamable HTTP." (condensed variant in `server.json` omits the transport suffix).

package/changelog/template.md

@@ -1,119 +0,0 @@
----
-# FORMAT REFERENCE — do not edit. Copy this file to
-# `changelog/<major.minor>.x/<version>.md` (e.g. `changelog/0.8.x/0.8.6.md`)
-# to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
-# with a concrete date.
-
-# Required. One-line GitHub Release-style headline. 350 character cap.
-# Default short and scannable. Don't pad, don't stitch unrelated changes with
-# semicolons — pick the headline. Quotes required: unquoted YAML treats `: `
-# inside the value as a key separator and fails GitHub's strict parser.
-summary: ""
-
-# Set `true` when consumers must change code to upgrade: API removals,
-# signature changes, config renames, behavior changes that break existing
-# usage. Flagged as `Breaking` in the rollup.
-breaking: false
-
-# Set `true` if this release contains any security fix. Pairs with the
-# `## Security` section below. Flagged as `Security` in the rollup so
-# users can triage upgrade urgency at a glance.
-security: false
----
-
-# <version> — YYYY-MM-DD
-
-<!--
-  AUTHORING GUIDE — applies to the new per-version file you create from this
-  template.
-
-  Audience: someone scanning release notes to decide what affects them. Lead
-  each bullet with the symbol or concept name in **bold** so they can skip
-  what's irrelevant and zoom in on what's not.
-
-  Tone: terse, fact-dense, not verbose. Default to one sentence per bullet —
-  name the symbol, state what changed, stop. Use a second sentence only when
-  it carries weight. If a bullet feels long, it is.
-
-  Cut: mechanism walkthroughs (those belong in JSDoc, AGENTS.md, or the
-  relevant skill), ceremonial framings ("This release introduces…",
-  backwards-compat paragraphs), file-by-file test enumerations, internal
-  implementation notes. Prefer code/symbol names over English re-explanations.
-
-  Narrative intro: skip by default. Add one short sentence only when the
-  release theme genuinely needs framing the bullets can't carry.
-
-  Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
-  Fixed, Security. Include only sections with entries; delete the rest
-  (including the commented-out scaffolding below). Don't ship empty headers.
-
-  Include: every distinct fact a reader needs to adopt or audit the release —
-  new exports, signatures, lint rule IDs, env vars, breaking changes, version
-  bumps on shipped skills. Nothing more.
-
-  Links: link issues, PRs, docs, or skills where they help a reader jump to
-  context. Once per item per entry — don't re-link the same issue in summary,
-  narrative, and bullet. Skip links for inline symbol names; code spans speak
-  for themselves.
-
-  Issue/PR URLs: use full URLs. GitHub's bare `#NN` auto-link only resolves
-  inside its own UI, not in npm reads or local editors.
-
-      [#38](https://github.com/cyanheads/mcp-ts-core/issues/38)   ← issue
-      [#42](https://github.com/cyanheads/mcp-ts-core/pull/42)     ← PR
-
-  Verify numbers exist before linking (`gh issue view NN`, `gh pr view NN`).
-  Never speculate on a future number — `#42` for an upcoming PR silently
-  resolves to whatever real item already owns 42, and timeline previews pull
-  in that unrelated item's metadata.
-
-  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
-  via `gh release create --notes-from-tag`. The tag is a derivative of this
-  changelog entry — a condensed, scannable version, not a copy. Format:
-
-    <theme — omit version number, GitHub prepends it>
-                                                          ← blank line
-    <1-2 sentence context: what this release does>
-                                                          ← blank line
-    Dependency bumps:                                     ← section header
-                                                          ← blank line
-    - `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6          ← bullet
-                                                          ← blank line
-    Changed:                                              ← only sections with entries
-                                                          ← blank line
-    - `format()` output includes `query` in text mode
-                                                          ← blank line
-    Added:
-                                                          ← blank line
-    - `manifest.json` scaffolded for MCPB bundle support
-    - Install badges (Claude Desktop, Cursor, VS Code)
-                                                          ← blank line
-    <N> tests pass; `bun run devcheck` clean.             ← footer
-
-  Never a flat comma-separated string. Always structured markdown with
-  sections. The tag must scan well as a rendered GitHub Release page.
--->
-
-## Added
-
--
-
-## Changed
-
--
-
-<!-- ## Deprecated
-
-- -->
-
-<!-- ## Removed
-
-- -->
-
-## Fixed
-
--
-
-<!-- ## Security
-
-- -->