mcp-grampsweb 1.0.0

package/dist/tools/search.js

@@ -0,0 +1,161 @@
+/**
+ * Search and retrieval tools
+ */
+import { grampsClient } from "../client.js";
+import { API_ENDPOINTS, ENTITY_ENDPOINT_MAP } from "../constants.js";
+import { searchSchema, findSchema, getEntitySchema } from "../schemas/search.js";
+import { formatSearchResults, formatEntity } from "../utils/formatting.js";
+/**
+ * GQL-based search for entities
+ */
+export async function grampsSearch(params) {
+    const { query, entity_type, page, pagesize } = searchSchema.parse(params);
+    const endpoint = ENTITY_ENDPOINT_MAP[entity_type];
+    if (!endpoint) {
+        throw new Error(`Unknown entity type: ${entity_type}`);
+    }
+    const response = await grampsClient.get(endpoint, {
+        gramps: query,
+        page,
+        pagesize,
+    });
+    // Format response
+    if (!response || (Array.isArray(response) && response.length === 0)) {
+        return `No ${entity_type} found matching query: ${query}`;
+    }
+    const results = (Array.isArray(response) ? response : [response]).map((obj) => ({
+        object_type: entity_type,
+        object: obj,
+    }));
+    return formatSearchResults(results);
+}
+/**
+ * Full-text search across all entities
+ */
+export async function grampsFind(params) {
+    const { query, page, pagesize } = findSchema.parse(params);
+    const response = await grampsClient.get(API_ENDPOINTS.SEARCH, {
+        query,
+        page,
+        pagesize,
+    });
+    if (!response.data || response.data.length === 0) {
+        return `No results found for: ${query}`;
+    }
+    let result = formatSearchResults(response.data);
+    if (response.total_count !== undefined) {
+        result += `\n\nTotal results: ${response.total_count}`;
+    }
+    return result;
+}
+/**
+ * Get a specific entity by handle or ID
+ */
+export async function grampsGet(params) {
+    const { entity_type, handle } = getEntitySchema.parse(params);
+    const endpoint = ENTITY_ENDPOINT_MAP[entity_type];
+    if (!endpoint) {
+        throw new Error(`Unknown entity type: ${entity_type}`);
+    }
+    // Try to get by handle first
+    try {
+        const response = await grampsClient.get(`${endpoint}${handle}`);
+        return formatEntity(response, entity_type);
+    }
+    catch (error) {
+        // If not found by handle, try searching by gramps_id
+        if (error instanceof Error && error.message.includes("404")) {
+            const searchResponse = await grampsClient.get(endpoint, {
+                gramps: `gramps_id=${handle}`,
+            });
+            if (searchResponse && searchResponse.length > 0) {
+                return formatEntity(searchResponse[0], entity_type);
+            }
+        }
+        throw error;
+    }
+}
+// Tool definitions for MCP
+export const searchTools = {
+    gramps_search: {
+        name: "gramps_search",
+        description: "Search for Gramps entities using GQL (Gramps Query Language). " +
+            "Examples: 'surname=Smith', 'gender=M', 'birth.date.year>1900'. " +
+            "Use for structured queries on specific entity types.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "GQL query string (e.g., 'surname=Smith', 'gender=M')",
+                },
+                entity_type: {
+                    type: "string",
+                    enum: ["people", "families", "events", "places", "sources", "citations", "repositories", "media", "notes"],
+                    description: "Type of entity to search",
+                },
+                page: {
+                    type: "number",
+                    description: "Page number (1-indexed)",
+                    default: 1,
+                },
+                pagesize: {
+                    type: "number",
+                    description: "Results per page (max 100)",
+                    default: 20,
+                },
+            },
+            required: ["query", "entity_type"],
+        },
+        handler: grampsSearch,
+    },
+    gramps_find: {
+        name: "gramps_find",
+        description: "Full-text search across all Gramps records. " +
+            "Use for finding people, places, sources, etc. by name or keyword. " +
+            "Returns results from all entity types.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Full-text search query",
+                },
+                page: {
+                    type: "number",
+                    description: "Page number (1-indexed)",
+                    default: 1,
+                },
+                pagesize: {
+                    type: "number",
+                    description: "Results per page (max 100)",
+                    default: 20,
+                },
+            },
+            required: ["query"],
+        },
+        handler: grampsFind,
+    },
+    gramps_get: {
+        name: "gramps_get",
+        description: "Get full details of a specific Gramps entity by its handle or Gramps ID. " +
+            "Use after finding an entity with search to get complete information.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entity_type: {
+                    type: "string",
+                    enum: ["people", "families", "events", "places", "sources", "citations", "repositories", "media", "notes"],
+                    description: "Type of entity to retrieve",
+                },
+                handle: {
+                    type: "string",
+                    description: "Entity handle or Gramps ID",
+                },
+            },
+            required: ["entity_type", "handle"],
+        },
+        handler: grampsGet,
+    },
+};
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Gramps Web API TypeScript interfaces
+ */
+export type EntityType = "people" | "families" | "events" | "places" | "sources" | "citations" | "repositories" | "media" | "notes";
+export interface TokenResponse {
+    access_token: string;
+    token_type: string;
+}
+export interface JWTPayload {
+    exp: number;
+    sub?: string;
+    [key: string]: unknown;
+}
+export interface GrampsEntity {
+    handle: string;
+    gramps_id: string;
+    change?: number;
+    private?: boolean;
+}
+export interface PersonName {
+    first_name?: string;
+    surname?: string;
+    suffix?: string;
+    title?: string;
+    type?: string;
+    primary?: boolean;
+    _class?: string;
+}
+export interface Person extends GrampsEntity {
+    primary_name?: PersonName;
+    alternate_names?: PersonName[];
+    gender?: number;
+    birth_ref_index?: number;
+    death_ref_index?: number;
+    event_ref_list?: EventRef[];
+    family_list?: string[];
+    parent_family_list?: string[];
+    media_list?: MediaRef[];
+    citation_list?: string[];
+    note_list?: string[];
+    attribute_list?: Attribute[];
+    tag_list?: string[];
+}
+export interface Family extends GrampsEntity {
+    father_handle?: string;
+    mother_handle?: string;
+    child_ref_list?: ChildRef[];
+    type?: string;
+    event_ref_list?: EventRef[];
+    media_list?: MediaRef[];
+    citation_list?: string[];
+    note_list?: string[];
+    attribute_list?: Attribute[];
+    tag_list?: string[];
+}
+export interface Event extends GrampsEntity {
+    type?: string;
+    date?: DateObject;
+    place?: string;
+    description?: string;
+    media_list?: MediaRef[];
+    citation_list?: string[];
+    note_list?: string[];
+    attribute_list?: Attribute[];
+    tag_list?: string[];
+}
+export interface Place extends GrampsEntity {
+    title?: string;
+    name?: PlaceName;
+    alt_names?: PlaceName[];
+    lat?: string;
+    long?: string;
+    placeref_list?: PlaceRef[];
+    place_type?: string;
+    media_list?: MediaRef[];
+    citation_list?: string[];
+    note_list?: string[];
+    tag_list?: string[];
+}
+export interface Source extends GrampsEntity {
+    title?: string;
+    author?: string;
+    pubinfo?: string;
+    abbrev?: string;
+    reporef_list?: RepoRef[];
+    media_list?: MediaRef[];
+    note_list?: string[];
+    tag_list?: string[];
+}
+export interface Citation extends GrampsEntity {
+    source_handle?: string;
+    page?: string;
+    confidence?: number;
+    date?: DateObject;
+    media_list?: MediaRef[];
+    note_list?: string[];
+    tag_list?: string[];
+}
+export interface Repository extends GrampsEntity {
+    name?: string;
+    type?: string;
+    address_list?: Address[];
+    urls?: Url[];
+    note_list?: string[];
+    tag_list?: string[];
+}
+export interface Media extends GrampsEntity {
+    path?: string;
+    mime?: string;
+    desc?: string;
+    checksum?: string;
+    date?: DateObject;
+    citation_list?: string[];
+    note_list?: string[];
+    attribute_list?: Attribute[];
+    tag_list?: string[];
+}
+export interface Note extends GrampsEntity {
+    text?: string;
+    format?: number;
+    type?: string;
+    tag_list?: string[];
+}
+export interface DateObject {
+    _class?: string;
+    calendar?: number;
+    modifier?: number;
+    quality?: number;
+    dateval?: number[];
+    text?: string;
+    sortval?: number;
+    newyear?: number;
+}
+export interface EventRef {
+    ref?: string;
+    role?: string;
+    _class?: string;
+}
+export interface ChildRef {
+    ref?: string;
+    frel?: string;
+    mrel?: string;
+    _class?: string;
+}
+export interface MediaRef {
+    ref?: string;
+    rect?: number[];
+    _class?: string;
+}
+export interface PlaceName {
+    value?: string;
+    date?: DateObject;
+    lang?: string;
+    _class?: string;
+}
+export interface PlaceRef {
+    ref?: string;
+    date?: DateObject;
+    _class?: string;
+}
+export interface RepoRef {
+    ref?: string;
+    call_number?: string;
+    media_type?: string;
+    _class?: string;
+}
+export interface Attribute {
+    type?: string;
+    value?: string;
+    _class?: string;
+}
+export interface Address {
+    street?: string;
+    locality?: string;
+    city?: string;
+    county?: string;
+    state?: string;
+    country?: string;
+    postal?: string;
+    phone?: string;
+    _class?: string;
+}
+export interface Url {
+    path?: string;
+    type?: string;
+    desc?: string;
+    _class?: string;
+}
+export interface SearchResult {
+    handle: string;
+    gramps_id: string;
+    object_type: string;
+    object: GrampsEntity;
+}
+export interface TreeStats {
+    people: number;
+    families: number;
+    events: number;
+    places: number;
+    sources: number;
+    citations: number;
+    repositories: number;
+    media: number;
+    notes: number;
+}
+export interface APIErrorResponse {
+    detail?: string;
+    message?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Gramps Web API TypeScript interfaces
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Error handling utilities
+ */
+export declare class GrampsAPIError extends Error {
+    readonly statusCode?: number | undefined;
+    readonly endpoint?: string | undefined;
+    constructor(message: string, statusCode?: number | undefined, endpoint?: string | undefined);
+}
+export declare class AuthenticationError extends GrampsAPIError {
+    constructor(message?: string);
+}
+export declare class NotFoundError extends GrampsAPIError {
+    constructor(entityType: string, identifier: string);
+}
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+export declare function formatErrorForMCP(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,cAAe,SAAQ,KAAK;aAGrB,UAAU,CAAC,EAAE,MAAM;aACnB,QAAQ,CAAC,EAAE,MAAM;gBAFjC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,QAAQ,CAAC,EAAE,MAAM,YAAA;CAKpC;AAED,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,GAAE,MAAgC;CAItD;AAED,qBAAa,aAAc,SAAQ,cAAc;gBACnC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAInD;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiBxD"}

package/dist/utils/errors.js

@@ -0,0 +1,48 @@
+/**
+ * Error handling utilities
+ */
+export class GrampsAPIError extends Error {
+    statusCode;
+    endpoint;
+    constructor(message, statusCode, endpoint) {
+        super(message);
+        this.statusCode = statusCode;
+        this.endpoint = endpoint;
+        this.name = "GrampsAPIError";
+    }
+}
+export class AuthenticationError extends GrampsAPIError {
+    constructor(message = "Authentication failed") {
+        super(message, 401);
+        this.name = "AuthenticationError";
+    }
+}
+export class NotFoundError extends GrampsAPIError {
+    constructor(entityType, identifier) {
+        super(`${entityType} not found: ${identifier}`, 404);
+        this.name = "NotFoundError";
+    }
+}
+export class ValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ValidationError";
+    }
+}
+export function formatErrorForMCP(error) {
+    if (error instanceof GrampsAPIError) {
+        let message = error.message;
+        if (error.statusCode) {
+            message = `[${error.statusCode}] ${message}`;
+        }
+        if (error.endpoint) {
+            message = `${message} (endpoint: ${error.endpoint})`;
+        }
+        return message;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGrB;IACA;IAHlB,YACE,OAAe,EACC,UAAmB,EACnB,QAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,eAAU,GAAV,UAAU,CAAS;QACnB,aAAQ,GAAR,QAAQ,CAAS;QAGjC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IACrD,YAAY,UAAkB,uBAAuB;QACnD,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C,YAAY,UAAkB,EAAE,UAAkB;QAChD,KAAK,CAAC,GAAG,UAAU,eAAe,UAAU,EAAE,EAAE,GAAG,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,IAAI,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC5B,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,GAAG,IAAI,KAAK,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;QAC/C,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,GAAG,GAAG,OAAO,eAAe,KAAK,CAAC,QAAQ,GAAG,CAAC;QACvD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/utils/formatting.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Response formatting utilities
+ */
+import type { Person, Family, Event, Place, Source, Citation, Note, Media, Repository, PersonName, DateObject, GrampsEntity } from "../types.js";
+/**
+ * Format a person name for display
+ */
+export declare function formatPersonName(name?: PersonName): string;
+/**
+ * Format a date object for display
+ */
+export declare function formatDate(date?: DateObject): string;
+/**
+ * Format a person entity for display
+ */
+export declare function formatPerson(person: Person): string;
+/**
+ * Format a family entity for display
+ */
+export declare function formatFamily(family: Family): string;
+/**
+ * Format an event entity for display
+ */
+export declare function formatEvent(event: Event): string;
+/**
+ * Format a place entity for display
+ */
+export declare function formatPlace(place: Place): string;
+/**
+ * Format a source entity for display
+ */
+export declare function formatSource(source: Source): string;
+/**
+ * Format a citation entity for display
+ */
+export declare function formatCitation(citation: Citation): string;
+/**
+ * Format a note entity for display
+ */
+export declare function formatNote(note: Note): string;
+/**
+ * Format a media entity for display
+ */
+export declare function formatMedia(media: Media): string;
+/**
+ * Format a repository entity for display
+ */
+export declare function formatRepository(repo: Repository): string;
+/**
+ * Format any entity based on its type
+ */
+export declare function formatEntity(entity: GrampsEntity, type: string): string;
+/**
+ * Format search results for display
+ */
+export declare function formatSearchResults(results: Array<{
+    object_type: string;
+    object: GrampsEntity;
+}>): string;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/utils/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/utils/formatting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,MAAM,EACN,MAAM,EACN,KAAK,EACL,KAAK,EACL,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,UAAU,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACb,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CAW1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CAiBpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAuBnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAoBnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAqBhD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAiBhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAgBnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CA4BzD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAiB7C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAgBhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAYzD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA+BvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC,GAC5D,MAAM,CAaR"}