@cyanheads/wikipedia-mcp-server 0.1.3

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

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview wikipedia_search tool — full-text search across Wikipedia articles.
+ * @module mcp-server/tools/definitions/wikipedia-search.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const wikipediaSearch: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    language: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        pageid: z.ZodNumber;
+        snippet: z.ZodString;
+        wordcount: z.ZodNumber;
+    }, z.core.$strip>>;
+    total_results: z.ZodNumber;
+    query_used: z.ZodString;
+    language: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_results";
+    readonly code: 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: 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-search.tool.d.ts.map

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

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

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

@@ -0,0 +1,91 @@
+/**
+ * @fileoverview wikipedia_search tool — full-text search across Wikipedia articles.
+ * @module mcp-server/tools/definitions/wikipedia-search.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getWikipediaService } from '../../../services/wikipedia/wikipedia-service.js';
+export const wikipediaSearch = tool('wikipedia_search', {
+    title: 'Search Wikipedia',
+    description: 'Search Wikipedia articles by full-text query. Returns ranked results with plain-text titles, snippets (HTML stripped), page IDs, and word counts. Best when the exact article title is unknown or when multiple articles on a topic are needed. Returned pageid values can be passed to other tools. Supports all Wikipedia language editions.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        query: z.string().describe('Search query (e.g. "Python programming language").'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .default(10)
+            .describe('Maximum number of results to return (default 10, max 50). Must be a positive integer.'),
+        language: z
+            .string()
+            .default('en')
+            .describe('Wikipedia language edition code (default "en"). Examples: "fr", "de", "ja".'),
+    }),
+    output: z.object({
+        results: z
+            .array(z
+            .object({
+            title: z.string().describe('Article title (e.g. "Python (programming language)").'),
+            pageid: z.number().describe('Wikipedia page ID — use as input to other tools.'),
+            snippet: z.string().describe('Plain-text search snippet with matched terms.'),
+            wordcount: z.number().describe('Article word count.'),
+        })
+            .describe('A single search result entry.'))
+            .describe('Ranked search results.'),
+        total_results: z.number().describe('Total number of matching results in Wikipedia.'),
+        query_used: z.string().describe('The query that was searched.'),
+        language: z.string().describe('Language edition queried.'),
+    }),
+    errors: [
+        {
+            reason: 'no_results',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Search returned zero results for the query.',
+            recovery: 'Broaden the query or try different keywords and search again.',
+        },
+        {
+            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;
+        const limit = Math.min(input.limit, 50);
+        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') });
+        }
+        ctx.log.info('Searching Wikipedia', { query: input.query, limit, language });
+        const svc = getWikipediaService();
+        const { results, totalResults } = await svc.search(input.query, limit, language, ctx);
+        if (results.length === 0) {
+            throw ctx.fail('no_results', `No Wikipedia articles found for query "${input.query}" in language "${language}".`, {
+                query: input.query,
+                language,
+                recovery: { hint: `Try different keywords or a broader query than "${input.query}".` },
+            });
+        }
+        ctx.log.info('Search complete', { count: results.length, totalResults, language });
+        return {
+            results,
+            total_results: totalResults,
+            query_used: input.query,
+            language,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**${result.results.length} of ${result.total_results} results** for "${result.query_used}" (${result.language})\n`,
+        ];
+        for (const item of result.results) {
+            lines.push(`### ${item.title}`);
+            lines.push(`**Page ID:** ${item.pageid} | **Words:** ${item.wordcount}`);
+            if (item.snippet)
+                lines.push(item.snippet);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=wikipedia-search.tool.js.map

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

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

package/dist/services/wikipedia/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @fileoverview Domain types for the Wikipedia service layer.
+ * @module services/wikipedia/types
+ */
+/** REST API summary response shape (partial — only fields we use). */
+export type RestSummaryRaw = {
+    type?: string;
+    title?: string;
+    pageid?: number;
+    wikibase_item?: string;
+    description?: string;
+    extract?: string;
+    thumbnail?: {
+        source?: string;
+        width?: number;
+        height?: number;
+    };
+};
+/** Action API search result entry. */
+export type ActionSearchResult = {
+    title: string;
+    pageid: number;
+    snippet: string;
+    wordcount?: number;
+};
+/** Action API search query response. */
+export type ActionSearchRaw = {
+    query?: {
+        searchinfo?: {
+            totalhits?: number;
+        };
+        search?: ActionSearchResult[];
+    };
+};
+/** Action API extracts response (for full article text). */
+export type ActionExtractsRaw = {
+    query?: {
+        pages?: Record<string, {
+            pageid?: number;
+            title?: string;
+            extract?: string;
+            missing?: string;
+        }>;
+    };
+};
+/** Action API parse/sections response. */
+export type ActionSectionsRaw = {
+    parse?: {
+        title?: string;
+        pageid?: number;
+        sections?: Array<{
+            toclevel?: number;
+            level?: string;
+            line?: string;
+            number?: string;
+            index?: string;
+            fromtitle?: string;
+            byteoffset?: number | null;
+            anchor?: string;
+        }>;
+    };
+    error?: {
+        code?: string;
+        info?: string;
+    };
+};
+/** Action API parse/wikitext response (formatversion=2 shape). */
+export type ActionWikitextRaw = {
+    parse?: {
+        title?: string;
+        pageid?: number;
+        /** formatversion=2: plain string. formatversion=1 used `{ '*': string }` — no longer used. */
+        wikitext?: string;
+    };
+    error?: {
+        code?: string;
+        info?: string;
+    };
+};
+/** Action API langlinks response (formatversion=2 shape, llprop=url). */
+export type ActionLangLinksRaw = {
+    query?: {
+        pages?: Record<string, {
+            pageid?: number;
+            title?: string;
+            missing?: string;
+            langlinks?: Array<{
+                lang: string;
+                /** formatversion=2: plain key. formatversion=1 used `'*'` — no longer used. */
+                title: string;
+                /** Present when llprop=url is passed. */
+                url?: string;
+            }>;
+        }>;
+    };
+};
+/** Action API geosearch response. */
+export type ActionGeoSearchRaw = {
+    query?: {
+        geosearch?: Array<{
+            pageid: number;
+            ns: number;
+            title: string;
+            lat: number;
+            lon: number;
+            dist: number;
+        }>;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/services/wikipedia/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/wikipedia/types.ts"],"names":[],"mappings":"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"}

package/dist/services/wikipedia/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Domain types for the Wikipedia service layer.
+ * @module services/wikipedia/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/wikipedia/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/wikipedia/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/services/wikipedia/wikipedia-service.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @fileoverview Wikipedia service — wraps the MediaWiki REST API and Action API.
+ * @module services/wikipedia/wikipedia-service
+ */
+import type { AppConfig } from '@cyanheads/mcp-ts-core/config';
+import type { StorageService } from '@cyanheads/mcp-ts-core/storage';
+import type { RequestContextLike } from '@cyanheads/mcp-ts-core/utils';
+export declare class WikipediaService {
+    private readonly userAgent;
+    constructor(_config: AppConfig, _storage: StorageService, userAgent: string);
+    /** Shared fetch headers for all requests. */
+    private headers;
+    /** GET from the REST API (`/api/rest_v1/`). */
+    restGet<T>(language: string, path: string, ctx: RequestContextLike): Promise<T>;
+    /** GET from the Action API (`/w/api.php`). */
+    actionGet<T>(language: string, params: Record<string, string>, ctx: RequestContextLike): Promise<T>;
+    /** Fetch the REST summary for an article. */
+    getSummary(title: string, language: string, ctx: RequestContextLike): Promise<{
+        title: string;
+        pageType: string;
+        pageid: number | undefined;
+        wikidataQid: string | undefined;
+        description: string | undefined;
+        extract: string;
+        thumbnailUrl: string | undefined;
+    }>;
+    /** Full-text search across Wikipedia articles. */
+    search(query: string, limit: number, language: string, ctx: RequestContextLike): Promise<{
+        results: Array<{
+            title: string;
+            pageid: number;
+            snippet: string;
+            wordcount: number;
+        }>;
+        totalResults: number;
+    }>;
+    /** Fetch full article plain text via Action API extracts. */
+    getArticleFull(title: string, language: string, ctx: RequestContextLike): Promise<{
+        title: string;
+        pageid: number | undefined;
+        content: string;
+    }>;
+    /** Fetch a single section's wikitext and strip it to plain text. */
+    getArticleSection(title: string, sectionIndex: number, language: string, ctx: RequestContextLike): Promise<{
+        title: string;
+        pageid: number | undefined;
+        sectionTitle: string;
+        content: string;
+    }>;
+    /** Fetch section table of contents for an article. */
+    getSections(title: string, language: string, ctx: RequestContextLike): Promise<{
+        pageid: number | undefined;
+        sections: Array<{
+            index: number;
+            number: string;
+            title: string;
+            level: number;
+        }>;
+    }>;
+    /** List language editions available for an article. */
+    getLanguages(title: string, sourceLanguage: string, ctx: RequestContextLike): Promise<{
+        languages: Array<{
+            languageCode: string;
+            title: string;
+            url: string;
+        }>;
+    }>;
+    /** Find geotagged Wikipedia articles near a coordinate. */
+    searchNearby(latitude: number, longitude: number, radiusMeters: number, limit: number, language: string, ctx: RequestContextLike): Promise<{
+        results: Array<{
+            title: string;
+            pageid: number;
+            latitude: number;
+            longitude: number;
+            distance_meters: number;
+        }>;
+    }>;
+}
+export declare function initWikipediaService(config: AppConfig, storage: StorageService, userAgent: string): void;
+export declare function getWikipediaService(): WikipediaService;
+//# sourceMappingURL=wikipedia-service.d.ts.map

package/dist/services/wikipedia/wikipedia-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikipedia-service.d.ts","sourceRoot":"","sources":["../../../src/services/wikipedia/wikipedia-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAQ/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAwVvE,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAF1B,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,cAAc,EACP,SAAS,EAAE,MAAM;IAGpC,6CAA6C;IAC7C,OAAO,CAAC,OAAO;IAOf,+CAA+C;IACzC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAsBrF,8CAA8C;IACxC,SAAS,CAAC,CAAC,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,CAAC,CAAC;IA2Bb,6CAA6C;IACvC,UAAU,CACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC;QACT,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;KAClC,CAAC;IAqCF,kDAAkD;IAC5C,MAAM,CACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC;QACT,OAAO,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACtF,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IA2BF,6DAA6D;IACvD,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA0C1E,oEAAoE;IAC9D,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAiDhG,sDAAsD;IAChD,WAAW,CACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,QAAQ,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClF,CAAC;IA8CF,uDAAuD;IACjD,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC;QACT,SAAS,EAAE,KAAK,CAAC;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACxE,CAAC;IAsCF,2DAA2D;IACrD,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC;QACT,OAAO,EAAE,KAAK,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC;YACjB,SAAS,EAAE,MAAM,CAAC;YAClB,eAAe,EAAE,MAAM,CAAC;SACzB,CAAC,CAAC;KACJ,CAAC;CAwBH;AAQD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,GAChB,IAAI,CAEN;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD"}