@cyanheads/wikipedia-mcp-server 0.1.3

package/changelog/template.md

@@ -0,0 +1,119 @@
+---
+# 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
+
+- -->

package/dist/config/server-config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Server-specific configuration for wikipedia-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+declare const ServerConfigSchema: z.ZodObject<{
+    baseUrl: z.ZodDefault<z.ZodString>;
+    userAgent: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type ServerConfig = z.infer<typeof ServerConfigSchema>;
+export declare function getServerConfig(): ServerConfig;
+export {};
+//# sourceMappingURL=server-config.d.ts.map

package/dist/config/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,QAAA,MAAM,kBAAkB;;;iBAStB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAM9C"}

package/dist/config/server-config.js

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Server-specific configuration for wikipedia-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+const ServerConfigSchema = z.object({
+    baseUrl: z
+        .string()
+        .default('https://en.wikipedia.org')
+        .describe('Base Wikipedia URL — language selection is per-call, not global'),
+    userAgent: z
+        .string()
+        .default('wikipedia-mcp-server/0.1.3 (https://github.com/cyanheads/wikipedia-mcp-server)')
+        .describe('User-Agent header sent with every request per Wikimedia policy'),
+});
+let _config;
+export function getServerConfig() {
+    _config ??= parseEnvConfig(ServerConfigSchema, {
+        baseUrl: 'WIKIPEDIA_BASE_URL',
+        userAgent: 'WIKIPEDIA_USER_AGENT',
+    });
+    return _config;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,OAAO,CAAC,0BAA0B,CAAC;SACnC,QAAQ,CAAC,iEAAiE,CAAC;IAC9E,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,OAAO,CAAC,gFAAgF,CAAC;SACzF,QAAQ,CAAC,gEAAgE,CAAC;CAC9E,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,OAAO,EAAE,oBAAoB;QAC7B,SAAS,EAAE,sBAAsB;KAClC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview wikipedia-mcp-server MCP server entry point.
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview wikipedia-mcp-server MCP server entry point.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { getServerConfig } from './config/server-config.js';
+import { allToolDefinitions } from './mcp-server/tools/definitions/index.js';
+import { initWikipediaService } from './services/wikipedia/wikipedia-service.js';
+await createApp({
+    tools: allToolDefinitions,
+    resources: [],
+    prompts: [],
+    instructions: `Wikipedia MCP server providing encyclopedic context via the MediaWiki REST API and Action API.
+- Use wikipedia_get_summary for "what is X?" lookups (90% of cases) — returns the lead section, Wikidata QID, and thumbnail.
+- Use wikipedia_search when the exact article title is unknown.
+- Use wikipedia_get_sections then wikipedia_get_article with section_index for targeted section reads — much smaller than full articles.
+- All tools support a language parameter (default "en") for multi-language workflows.
+- wikipedia_get_summary returns page_type: "disambiguation" for disambiguation pages — follow up with wikipedia_search.`,
+    setup(core) {
+        const serverConfig = getServerConfig();
+        initWikipediaService(core.config, core.storage, serverConfig.userAgent);
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,MAAM,SAAS,CAAC;IACd,KAAK,EAAE,kBAAkB;IACzB,SAAS,EAAE,EAAE;IACb,OAAO,EAAE,EAAE;IACX,YAAY,EAAE;;;;;wHAKwG;IACtH,KAAK,CAAC,IAAI;QACR,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,oBAAoB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1E,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -0,0 +1,168 @@
+/**
+ * @fileoverview Barrel export for all tool definitions.
+ * @module mcp-server/tools/definitions/index
+ */
+export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    title: import("zod").ZodString;
+    section_index: import("zod").ZodOptional<import("zod").ZodNumber>;
+    language: import("zod").ZodDefault<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    title: import("zod").ZodString;
+    pageid: import("zod").ZodOptional<import("zod").ZodNumber>;
+    content: import("zod").ZodString;
+    section_title: import("zod").ZodOptional<import("zod").ZodString>;
+    content_type: import("zod").ZodString;
+    language: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No Wikipedia article exists for the given title.";
+    readonly recovery: "Use wikipedia_search to discover the correct article title and try again.";
+}, {
+    readonly reason: "invalid_section";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
+    readonly when: "The section_index is out of range for this article.";
+    readonly recovery: "Call wikipedia_get_sections first to obtain valid section_index values.";
+}, {
+    readonly reason: "invalid_language";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
+    readonly when: "The language code is not a valid BCP 47 code.";
+    readonly recovery: "Use a valid BCP 47 language code such as \"fr\", \"de\", or \"ja\".";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    title: import("zod").ZodString;
+    language: import("zod").ZodDefault<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    source_title: import("zod").ZodString;
+    source_language: import("zod").ZodString;
+    languages: import("zod").ZodArray<import("zod").ZodObject<{
+        language_code: import("zod").ZodString;
+        title: import("zod").ZodString;
+        url: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    total_languages: import("zod").ZodNumber;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No Wikipedia article exists for the title in the specified language.";
+    readonly recovery: "Use wikipedia_search to discover the correct article title and try again.";
+}, {
+    readonly reason: "no_other_languages";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Article exists but has no other language editions.";
+    readonly recovery: "The article may be too new or too regional to have been translated yet.";
+}, {
+    readonly reason: "invalid_language";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
+    readonly when: "The language code is not a valid BCP 47 code.";
+    readonly recovery: "Use a valid BCP 47 language code such as \"fr\", \"de\", or \"ja\".";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    title: import("zod").ZodString;
+    language: import("zod").ZodDefault<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    title: import("zod").ZodString;
+    pageid: import("zod").ZodOptional<import("zod").ZodNumber>;
+    sections: import("zod").ZodArray<import("zod").ZodObject<{
+        index: import("zod").ZodNumber;
+        number: import("zod").ZodString;
+        title: import("zod").ZodString;
+        level: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>>;
+    total_sections: import("zod").ZodNumber;
+    language: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No Wikipedia article exists for the given title.";
+    readonly recovery: "Use wikipedia_search to discover the correct article title and try again.";
+}, {
+    readonly reason: "no_sections";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Article exists but has no sections (stub or very short article).";
+    readonly recovery: "Use wikipedia_get_article without section_index to read the full short article.";
+}, {
+    readonly reason: "invalid_language";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
+    readonly when: "The language code is not a valid BCP 47 code.";
+    readonly recovery: "Use a valid BCP 47 language code such as \"fr\", \"de\", or \"ja\".";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    title: import("zod").ZodString;
+    language: import("zod").ZodDefault<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    title: import("zod").ZodString;
+    page_type: import("zod").ZodString;
+    pageid: import("zod").ZodOptional<import("zod").ZodNumber>;
+    wikibase_item: import("zod").ZodOptional<import("zod").ZodString>;
+    description: import("zod").ZodOptional<import("zod").ZodString>;
+    extract: import("zod").ZodString;
+    thumbnail_url: import("zod").ZodOptional<import("zod").ZodString>;
+    language: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No Wikipedia article exists for the given title.";
+    readonly recovery: "Use wikipedia_search to discover the correct article title and try again.";
+}, {
+    readonly reason: "invalid_language";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
+    readonly when: "The language code is not a valid BCP 47 code.";
+    readonly recovery: "Use a valid BCP 47 language code such as \"fr\", \"de\", or \"ja\".";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    query: import("zod").ZodString;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+    language: import("zod").ZodDefault<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    results: import("zod").ZodArray<import("zod").ZodObject<{
+        title: import("zod").ZodString;
+        pageid: import("zod").ZodNumber;
+        snippet: import("zod").ZodString;
+        wordcount: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>>;
+    total_results: import("zod").ZodNumber;
+    query_used: import("zod").ZodString;
+    language: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_results";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Search returned zero results for the query.";
+    readonly recovery: "Broaden the query or try different keywords and search again.";
+}, {
+    readonly reason: "invalid_language";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
+    readonly when: "The language code is not a valid BCP 47 code.";
+    readonly recovery: "Use a valid BCP 47 language code such as \"fr\", \"de\", or \"ja\".";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    latitude: import("zod").ZodNumber;
+    longitude: import("zod").ZodNumber;
+    radius_meters: import("zod").ZodDefault<import("zod").ZodNumber>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+    language: import("zod").ZodDefault<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    results: import("zod").ZodArray<import("zod").ZodObject<{
+        title: import("zod").ZodString;
+        pageid: import("zod").ZodNumber;
+        latitude: import("zod").ZodNumber;
+        longitude: import("zod").ZodNumber;
+        distance_meters: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>>;
+    total_results: import("zod").ZodNumber;
+    query_latitude: import("zod").ZodNumber;
+    query_longitude: import("zod").ZodNumber;
+    radius_meters_used: import("zod").ZodNumber;
+    language: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_results";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No geotagged articles found within the search radius.";
+    readonly recovery: "Increase radius_meters or verify the coordinates are correct and retry.";
+}, {
+    readonly reason: "invalid_coordinates";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
+    readonly when: "Latitude or longitude is outside valid WGS 84 range.";
+    readonly recovery: "Latitude must be between −90 and 90; longitude between −180 and 180.";
+}, {
+    readonly reason: "invalid_language";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
+    readonly when: "The language code is not a valid BCP 47 code.";
+    readonly recovery: "Use a valid BCP 47 language code such as \"fr\", \"de\", or \"ja\".";
+}]>)[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/tools/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAO9B,CAAC"}

package/dist/mcp-server/tools/definitions/index.js

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Barrel export for all tool definitions.
+ * @module mcp-server/tools/definitions/index
+ */
+import { wikipediaGetArticle } from './wikipedia-get-article.tool.js';
+import { wikipediaGetLanguages } from './wikipedia-get-languages.tool.js';
+import { wikipediaGetSections } from './wikipedia-get-sections.tool.js';
+import { wikipediaGetSummary } from './wikipedia-get-summary.tool.js';
+import { wikipediaSearch } from './wikipedia-search.tool.js';
+import { wikipediaSearchNearby } from './wikipedia-search-nearby.tool.js';
+export const allToolDefinitions = [
+    wikipediaSearch,
+    wikipediaGetSummary,
+    wikipediaGetArticle,
+    wikipediaGetSections,
+    wikipediaSearchNearby,
+    wikipediaGetLanguages,
+];
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,eAAe;IACf,mBAAmB;IACnB,mBAAmB;IACnB,oBAAoB;IACpB,qBAAqB;IACrB,qBAAqB;CACtB,CAAC"}

package/dist/mcp-server/tools/definitions/wikipedia-get-article.tool.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview wikipedia_get_article tool — fetch article content as clean plain text.
+ * @module mcp-server/tools/definitions/wikipedia-get-article.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const wikipediaGetArticle: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    title: z.ZodString;
+    section_index: z.ZodOptional<z.ZodNumber>;
+    language: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    title: z.ZodString;
+    pageid: z.ZodOptional<z.ZodNumber>;
+    content: z.ZodString;
+    section_title: z.ZodOptional<z.ZodString>;
+    content_type: z.ZodString;
+    language: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No Wikipedia article exists for the given title.";
+    readonly recovery: "Use wikipedia_search to discover the correct article title and try again.";
+}, {
+    readonly reason: "invalid_section";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "The section_index is out of range for this article.";
+    readonly recovery: "Call wikipedia_get_sections first to obtain valid section_index values.";
+}, {
+    readonly reason: "invalid_language";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "The language code is not a valid BCP 47 code.";
+    readonly recovery: "Use a valid BCP 47 language code such as \"fr\", \"de\", or \"ja\".";
+}]>;
+//# sourceMappingURL=wikipedia-get-article.tool.d.ts.map

package/dist/mcp-server/tools/definitions/wikipedia-get-article.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikipedia-get-article.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/wikipedia-get-article.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;GAkK9B,CAAC"}

package/dist/mcp-server/tools/definitions/wikipedia-get-article.tool.js

@@ -0,0 +1,153 @@
+/**
+ * @fileoverview wikipedia_get_article tool — fetch article content as clean plain text.
+ * @module mcp-server/tools/definitions/wikipedia-get-article.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getWikipediaService } from '../../../services/wikipedia/wikipedia-service.js';
+export const wikipediaGetArticle = tool('wikipedia_get_article', {
+    title: 'Get Wikipedia Article',
+    description: 'Fetch article content as clean plain text. Without section_index: returns the full article with == Section == markers preserved for structure. With section_index (from wikipedia_get_sections): returns just that section as plain text. Section-targeted reads are faster and smaller when only part of the article is needed.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        title: z.string().describe('Article title (e.g. "Python (programming language)").'),
+        section_index: z
+            .number()
+            .optional()
+            .describe('Section index from wikipedia_get_sections. Omit for the full article. Providing this returns only the targeted section as plain text.'),
+        language: z
+            .string()
+            .default('en')
+            .describe('Wikipedia language edition code (default "en"). Examples: "fr", "de", "ja".'),
+    }),
+    output: z.object({
+        title: z.string().describe('Resolved article title.'),
+        pageid: z
+            .number()
+            .optional()
+            .describe('Wikipedia page ID. Absent on API parse responses that omit it.'),
+        content: z
+            .string()
+            .describe('Plain-text article content. Full articles include == Section == markers.'),
+        section_title: z
+            .string()
+            .optional()
+            .describe('Section title when section_index was provided. Absent for full-article reads.'),
+        content_type: z.string().describe('Content type: "full_article" or "section".'),
+        language: z.string().describe('Language edition queried.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No Wikipedia article exists for the given title.',
+            recovery: 'Use wikipedia_search to discover the correct article title and try again.',
+        },
+        {
+            reason: 'invalid_section',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'The section_index is out of range for this article.',
+            recovery: 'Call wikipedia_get_sections first to obtain valid section_index values.',
+        },
+        {
+            reason: 'invalid_language',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'The language code is not a valid BCP 47 code.',
+            recovery: 'Use a valid BCP 47 language code such as "fr", "de", or "ja".',
+        },
+    ],
+    async handler(input, ctx) {
+        const { language } = input;
+        // Validate language code eagerly so the contract reason appears in data.reason.
+        if (!/^[a-z]{2,3}(-[a-z0-9]+)*$/i.test(language)) {
+            throw ctx.fail('invalid_language', `Invalid language code "${language}". Use a BCP 47 language code such as "fr", "de", or "ja".`, { language, ...ctx.recoveryFor('invalid_language') });
+        }
+        // Reject section_index < 1 — indices start at 1 (wikipedia_get_sections output).
+        // Index 0 refers to the lead section (wikitext parsing returns templates/infoboxes, not
+        // readable text); negative values are nonsensical and leak a raw API error.
+        // Full-article reads handle the lead via the extracts API.
+        if (input.section_index != null && input.section_index < 1) {
+            throw ctx.fail('invalid_section', `section_index ${input.section_index} is not valid. Section indices start at 1 (use wikipedia_get_sections to discover valid values). To read the lead section, omit section_index entirely.`, {
+                sectionIndex: input.section_index,
+                recovery: {
+                    hint: 'Use wikipedia_get_sections to get valid indices (starting at 1). Omit section_index to read the full article including its lead section.',
+                },
+            });
+        }
+        const svc = getWikipediaService();
+        if (input.section_index != null) {
+            // Section-targeted path: wikitext + stripping
+            ctx.log.info('Fetching article section', {
+                title: input.title,
+                sectionIndex: input.section_index,
+                language,
+            });
+            let result;
+            try {
+                result = await svc.getArticleSection(input.title, input.section_index, language, ctx);
+            }
+            catch (err) {
+                if (err instanceof McpError && err.code === JsonRpcErrorCode.NotFound) {
+                    throw ctx.fail('not_found', err.message, {
+                        title: input.title,
+                        language,
+                        recovery: { hint: 'Use wikipedia_search to find the correct article title.' },
+                    });
+                }
+                throw err;
+            }
+            ctx.log.info('Section fetched', {
+                title: result.title,
+                sectionTitle: result.sectionTitle,
+                contentLength: result.content.length,
+            });
+            return {
+                title: result.title,
+                pageid: result.pageid,
+                content: result.content,
+                section_title: result.sectionTitle,
+                content_type: 'section',
+                language,
+            };
+        }
+        // Full-article path
+        ctx.log.info('Fetching full article', { title: input.title, language });
+        let result;
+        try {
+            result = await svc.getArticleFull(input.title, language, ctx);
+        }
+        catch (err) {
+            if (err instanceof McpError && err.code === JsonRpcErrorCode.NotFound) {
+                throw ctx.fail('not_found', err.message, {
+                    title: input.title,
+                    language,
+                    recovery: { hint: 'Use wikipedia_search to find the correct article title.' },
+                });
+            }
+            throw err;
+        }
+        ctx.log.info('Article fetched', {
+            title: result.title,
+            contentLength: result.content.length,
+        });
+        return {
+            title: result.title,
+            pageid: result.pageid,
+            content: result.content,
+            content_type: 'full_article',
+            language,
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`# ${result.title}`);
+        lines.push(`**Type:** ${result.content_type} | **Language:** ${result.language}` +
+            (result.pageid != null ? ` | **Page ID:** ${result.pageid}` : ''));
+        if (result.section_title)
+            lines.push(`**Section:** ${result.section_title}`);
+        lines.push('');
+        lines.push(result.content);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=wikipedia-get-article.tool.js.map

package/dist/mcp-server/tools/definitions/wikipedia-get-article.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikipedia-get-article.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/wikipedia-get-article.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/wikipedia-get-languages.tool.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview wikipedia_get_languages tool — list language editions available for a Wikipedia article.
+ * @module mcp-server/tools/definitions/wikipedia-get-languages.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const wikipediaGetLanguages: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    title: z.ZodString;
+    language: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    source_title: z.ZodString;
+    source_language: z.ZodString;
+    languages: z.ZodArray<z.ZodObject<{
+        language_code: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>>;
+    total_languages: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No Wikipedia article exists for the title in the specified language.";
+    readonly recovery: "Use wikipedia_search to discover the correct article title and try again.";
+}, {
+    readonly reason: "no_other_languages";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Article exists but has no other language editions.";
+    readonly recovery: "The article may be too new or too regional to have been translated yet.";
+}, {
+    readonly reason: "invalid_language";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "The language code is not a valid BCP 47 code.";
+    readonly recovery: "Use a valid BCP 47 language code such as \"fr\", \"de\", or \"ja\".";
+}]>;
+//# sourceMappingURL=wikipedia-get-languages.tool.d.ts.map