mcp-grampsweb 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Gramps Web MCP Server
+ *
+ * An MCP server that provides tools for interacting with the Gramps Web API
+ * for genealogy research.
+ */
+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":";AAEA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+/**
+ * Gramps Web MCP Server
+ *
+ * An MCP server that provides tools for interacting with the Gramps Web API
+ * for genealogy research.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { loadConfig } from "./config.js";
+import { authManager } from "./auth.js";
+import { grampsClient } from "./client.js";
+import { allTools } from "./tools/index.js";
+import { formatErrorForMCP } from "./utils/errors.js";
+// Logger that writes to stderr (stdout is for MCP JSON-RPC)
+const log = {
+    info: (msg) => console.error(`[INFO] ${msg}`),
+    error: (msg) => console.error(`[ERROR] ${msg}`),
+    debug: (msg) => {
+        if (process.env.DEBUG) {
+            console.error(`[DEBUG] ${msg}`);
+        }
+    },
+};
+async function main() {
+    log.info("Starting Gramps Web MCP Server...");
+    // Load and validate configuration
+    let config;
+    try {
+        config = loadConfig();
+        log.info(`Connecting to Gramps Web at: ${config.apiUrl}`);
+    }
+    catch (error) {
+        log.error(formatErrorForMCP(error));
+        process.exit(1);
+    }
+    // Initialize auth manager and API client
+    authManager.initialize(config);
+    grampsClient.initialize(config);
+    // Test authentication
+    try {
+        await authManager.getToken();
+        log.info("Authentication successful");
+    }
+    catch (error) {
+        log.error(`Authentication failed: ${formatErrorForMCP(error)}`);
+        process.exit(1);
+    }
+    // Create MCP server
+    const server = new Server({
+        name: "gramps-web",
+        version: "1.0.0",
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Register tool list handler
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        const tools = Object.values(allTools).map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+        }));
+        return { tools };
+    });
+    // Register tool call handler
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        log.debug(`Tool called: ${name}`);
+        const tool = allTools[name];
+        if (!tool) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Unknown tool: ${name}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const result = await tool.handler(args);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: result,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = formatErrorForMCP(error);
+            log.error(`Tool ${name} failed: ${errorMessage}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Set up error handlers
+    server.onerror = (error) => {
+        log.error(`Server error: ${error.message}`);
+    };
+    process.on("SIGINT", async () => {
+        log.info("Shutting down...");
+        await server.close();
+        process.exit(0);
+    });
+    process.on("SIGTERM", async () => {
+        log.info("Shutting down...");
+        await server.close();
+        process.exit(0);
+    });
+    // Start the server
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log.info("Gramps Web MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/schemas/common.d.ts

@@ -0,0 +1,308 @@
+/**
+ * Shared Zod schemas for common types
+ */
+import { z } from "zod";
+export declare const entityTypeSchema: z.ZodEnum<["people", "families", "events", "places", "sources", "citations", "repositories", "media", "notes"]>;
+export declare const handleOrIdSchema: z.ZodString;
+export declare const dateSchema: z.ZodOptional<z.ZodObject<{
+    _class: z.ZodOptional<z.ZodLiteral<"Date">>;
+    calendar: z.ZodOptional<z.ZodNumber>;
+    modifier: z.ZodOptional<z.ZodNumber>;
+    quality: z.ZodOptional<z.ZodNumber>;
+    dateval: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    text: z.ZodOptional<z.ZodString>;
+    sortval: z.ZodOptional<z.ZodNumber>;
+    newyear: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    _class?: "Date" | undefined;
+    calendar?: number | undefined;
+    modifier?: number | undefined;
+    quality?: number | undefined;
+    dateval?: number[] | undefined;
+    text?: string | undefined;
+    sortval?: number | undefined;
+    newyear?: number | undefined;
+}, {
+    _class?: "Date" | undefined;
+    calendar?: number | undefined;
+    modifier?: number | undefined;
+    quality?: number | undefined;
+    dateval?: number[] | undefined;
+    text?: string | undefined;
+    sortval?: number | undefined;
+    newyear?: number | undefined;
+}>>;
+export declare const personNameSchema: z.ZodObject<{
+    _class: z.ZodOptional<z.ZodLiteral<"Name">>;
+    first_name: z.ZodOptional<z.ZodString>;
+    surname: z.ZodOptional<z.ZodString>;
+    suffix: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    primary: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    _class?: "Name" | undefined;
+    type?: string | undefined;
+    first_name?: string | undefined;
+    surname?: string | undefined;
+    suffix?: string | undefined;
+    title?: string | undefined;
+    primary?: boolean | undefined;
+}, {
+    _class?: "Name" | undefined;
+    type?: string | undefined;
+    first_name?: string | undefined;
+    surname?: string | undefined;
+    suffix?: string | undefined;
+    title?: string | undefined;
+    primary?: boolean | undefined;
+}>;
+export declare const eventRefSchema: z.ZodObject<{
+    _class: z.ZodOptional<z.ZodLiteral<"EventRef">>;
+    ref: z.ZodString;
+    role: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    ref: string;
+    _class?: "EventRef" | undefined;
+    role?: string | undefined;
+}, {
+    ref: string;
+    _class?: "EventRef" | undefined;
+    role?: string | undefined;
+}>;
+export declare const childRefSchema: z.ZodObject<{
+    _class: z.ZodOptional<z.ZodLiteral<"ChildRef">>;
+    ref: z.ZodString;
+    frel: z.ZodOptional<z.ZodString>;
+    mrel: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    ref: string;
+    _class?: "ChildRef" | undefined;
+    frel?: string | undefined;
+    mrel?: string | undefined;
+}, {
+    ref: string;
+    _class?: "ChildRef" | undefined;
+    frel?: string | undefined;
+    mrel?: string | undefined;
+}>;
+export declare const mediaRefSchema: z.ZodObject<{
+    _class: z.ZodOptional<z.ZodLiteral<"MediaRef">>;
+    ref: z.ZodString;
+    rect: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+}, "strip", z.ZodTypeAny, {
+    ref: string;
+    _class?: "MediaRef" | undefined;
+    rect?: number[] | undefined;
+}, {
+    ref: string;
+    _class?: "MediaRef" | undefined;
+    rect?: number[] | undefined;
+}>;
+export declare const placeRefSchema: z.ZodObject<{
+    _class: z.ZodOptional<z.ZodLiteral<"PlaceRef">>;
+    ref: z.ZodString;
+    date: z.ZodOptional<z.ZodObject<{
+        _class: z.ZodOptional<z.ZodLiteral<"Date">>;
+        calendar: z.ZodOptional<z.ZodNumber>;
+        modifier: z.ZodOptional<z.ZodNumber>;
+        quality: z.ZodOptional<z.ZodNumber>;
+        dateval: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        text: z.ZodOptional<z.ZodString>;
+        sortval: z.ZodOptional<z.ZodNumber>;
+        newyear: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        _class?: "Date" | undefined;
+        calendar?: number | undefined;
+        modifier?: number | undefined;
+        quality?: number | undefined;
+        dateval?: number[] | undefined;
+        text?: string | undefined;
+        sortval?: number | undefined;
+        newyear?: number | undefined;
+    }, {
+        _class?: "Date" | undefined;
+        calendar?: number | undefined;
+        modifier?: number | undefined;
+        quality?: number | undefined;
+        dateval?: number[] | undefined;
+        text?: string | undefined;
+        sortval?: number | undefined;
+        newyear?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    ref: string;
+    _class?: "PlaceRef" | undefined;
+    date?: {
+        _class?: "Date" | undefined;
+        calendar?: number | undefined;
+        modifier?: number | undefined;
+        quality?: number | undefined;
+        dateval?: number[] | undefined;
+        text?: string | undefined;
+        sortval?: number | undefined;
+        newyear?: number | undefined;
+    } | undefined;
+}, {
+    ref: string;
+    _class?: "PlaceRef" | undefined;
+    date?: {
+        _class?: "Date" | undefined;
+        calendar?: number | undefined;
+        modifier?: number | undefined;
+        quality?: number | undefined;
+        dateval?: number[] | undefined;
+        text?: string | undefined;
+        sortval?: number | undefined;
+        newyear?: number | undefined;
+    } | undefined;
+}>;
+export declare const repoRefSchema: z.ZodObject<{
+    _class: z.ZodOptional<z.ZodLiteral<"RepoRef">>;
+    ref: z.ZodString;
+    call_number: z.ZodOptional<z.ZodString>;
+    media_type: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    ref: string;
+    _class?: "RepoRef" | undefined;
+    call_number?: string | undefined;
+    media_type?: string | undefined;
+}, {
+    ref: string;
+    _class?: "RepoRef" | undefined;
+    call_number?: string | undefined;
+    media_type?: string | undefined;
+}>;
+export declare const attributeSchema: z.ZodObject<{
+    _class: z.ZodOptional<z.ZodLiteral<"Attribute">>;
+    type: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    value?: string | undefined;
+    _class?: "Attribute" | undefined;
+    type?: string | undefined;
+}, {
+    value?: string | undefined;
+    _class?: "Attribute" | undefined;
+    type?: string | undefined;
+}>;
+export declare const urlSchema: z.ZodObject<{
+    _class: z.ZodOptional<z.ZodLiteral<"Url">>;
+    path: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    desc: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    _class?: "Url" | undefined;
+    path?: string | undefined;
+    type?: string | undefined;
+    desc?: string | undefined;
+}, {
+    _class?: "Url" | undefined;
+    path?: string | undefined;
+    type?: string | undefined;
+    desc?: string | undefined;
+}>;
+export declare const addressSchema: z.ZodObject<{
+    _class: z.ZodOptional<z.ZodLiteral<"Address">>;
+    street: z.ZodOptional<z.ZodString>;
+    locality: z.ZodOptional<z.ZodString>;
+    city: z.ZodOptional<z.ZodString>;
+    county: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodString>;
+    country: z.ZodOptional<z.ZodString>;
+    postal: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    _class?: "Address" | undefined;
+    street?: string | undefined;
+    locality?: string | undefined;
+    city?: string | undefined;
+    county?: string | undefined;
+    state?: string | undefined;
+    country?: string | undefined;
+    postal?: string | undefined;
+    phone?: string | undefined;
+}, {
+    _class?: "Address" | undefined;
+    street?: string | undefined;
+    locality?: string | undefined;
+    city?: string | undefined;
+    county?: string | undefined;
+    state?: string | undefined;
+    country?: string | undefined;
+    postal?: string | undefined;
+    phone?: string | undefined;
+}>;
+export declare const placeNameSchema: z.ZodObject<{
+    _class: z.ZodOptional<z.ZodLiteral<"PlaceName">>;
+    value: z.ZodOptional<z.ZodString>;
+    date: z.ZodOptional<z.ZodObject<{
+        _class: z.ZodOptional<z.ZodLiteral<"Date">>;
+        calendar: z.ZodOptional<z.ZodNumber>;
+        modifier: z.ZodOptional<z.ZodNumber>;
+        quality: z.ZodOptional<z.ZodNumber>;
+        dateval: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        text: z.ZodOptional<z.ZodString>;
+        sortval: z.ZodOptional<z.ZodNumber>;
+        newyear: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        _class?: "Date" | undefined;
+        calendar?: number | undefined;
+        modifier?: number | undefined;
+        quality?: number | undefined;
+        dateval?: number[] | undefined;
+        text?: string | undefined;
+        sortval?: number | undefined;
+        newyear?: number | undefined;
+    }, {
+        _class?: "Date" | undefined;
+        calendar?: number | undefined;
+        modifier?: number | undefined;
+        quality?: number | undefined;
+        dateval?: number[] | undefined;
+        text?: string | undefined;
+        sortval?: number | undefined;
+        newyear?: number | undefined;
+    }>>;
+    lang: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    value?: string | undefined;
+    _class?: "PlaceName" | undefined;
+    date?: {
+        _class?: "Date" | undefined;
+        calendar?: number | undefined;
+        modifier?: number | undefined;
+        quality?: number | undefined;
+        dateval?: number[] | undefined;
+        text?: string | undefined;
+        sortval?: number | undefined;
+        newyear?: number | undefined;
+    } | undefined;
+    lang?: string | undefined;
+}, {
+    value?: string | undefined;
+    _class?: "PlaceName" | undefined;
+    date?: {
+        _class?: "Date" | undefined;
+        calendar?: number | undefined;
+        modifier?: number | undefined;
+        quality?: number | undefined;
+        dateval?: number[] | undefined;
+        text?: string | undefined;
+        sortval?: number | undefined;
+        newyear?: number | undefined;
+    } | undefined;
+    lang?: string | undefined;
+}>;
+export declare const genderSchema: z.ZodEffects<z.ZodEnum<["male", "female", "unknown"]>, 0 | 1 | 2, "male" | "female" | "unknown">;
+export declare const paginationSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodNumber>;
+    pagesize: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    pagesize: number;
+}, {
+    page?: number | undefined;
+    pagesize?: number | undefined;
+}>;
+//# sourceMappingURL=common.d.ts.map

package/dist/schemas/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,gBAAgB,iHAU3B,CAAC;AAGH,eAAO,MAAM,gBAAgB,aAA2D,CAAC;AAGzF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;GASV,CAAC;AAGd,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;EAQ3B,CAAC;AAGH,eAAO,MAAM,cAAc;;;;;;;;;;;;EAIzB,CAAC;AAGH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAKzB,CAAC;AAGH,eAAO,MAAM,cAAc;;;;;;;;;;;;EAIzB,CAAC;AAGH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIzB,CAAC;AAGH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAKxB,CAAC;AAGH,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAC;AAGH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;EAKpB,CAAC;AAGH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUxB,CAAC;AAGH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK1B,CAAC;AAGH,eAAO,MAAM,YAAY,kGASvB,CAAC;AAGH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC"}

package/dist/schemas/common.js

@@ -0,0 +1,120 @@
+/**
+ * Shared Zod schemas for common types
+ */
+import { z } from "zod";
+// Entity type schema
+export const entityTypeSchema = z.enum([
+    "people",
+    "families",
+    "events",
+    "places",
+    "sources",
+    "citations",
+    "repositories",
+    "media",
+    "notes",
+]);
+// Handle or Gramps ID schema
+export const handleOrIdSchema = z.string().min(1).describe("Entity handle or Gramps ID");
+// Date schema for Gramps
+export const dateSchema = z.object({
+    _class: z.literal("Date").optional(),
+    calendar: z.number().optional(),
+    modifier: z.number().optional(),
+    quality: z.number().optional(),
+    dateval: z.array(z.number()).optional(),
+    text: z.string().optional(),
+    sortval: z.number().optional(),
+    newyear: z.number().optional(),
+}).optional();
+// Person name schema
+export const personNameSchema = z.object({
+    _class: z.literal("Name").optional(),
+    first_name: z.string().optional(),
+    surname: z.string().optional(),
+    suffix: z.string().optional(),
+    title: z.string().optional(),
+    type: z.string().optional(),
+    primary: z.boolean().optional(),
+});
+// Event reference schema
+export const eventRefSchema = z.object({
+    _class: z.literal("EventRef").optional(),
+    ref: z.string(),
+    role: z.string().optional(),
+});
+// Child reference schema
+export const childRefSchema = z.object({
+    _class: z.literal("ChildRef").optional(),
+    ref: z.string(),
+    frel: z.string().optional(),
+    mrel: z.string().optional(),
+});
+// Media reference schema
+export const mediaRefSchema = z.object({
+    _class: z.literal("MediaRef").optional(),
+    ref: z.string(),
+    rect: z.array(z.number()).optional(),
+});
+// Place reference schema
+export const placeRefSchema = z.object({
+    _class: z.literal("PlaceRef").optional(),
+    ref: z.string(),
+    date: dateSchema,
+});
+// Repository reference schema
+export const repoRefSchema = z.object({
+    _class: z.literal("RepoRef").optional(),
+    ref: z.string(),
+    call_number: z.string().optional(),
+    media_type: z.string().optional(),
+});
+// Attribute schema
+export const attributeSchema = z.object({
+    _class: z.literal("Attribute").optional(),
+    type: z.string().optional(),
+    value: z.string().optional(),
+});
+// URL schema
+export const urlSchema = z.object({
+    _class: z.literal("Url").optional(),
+    path: z.string().optional(),
+    type: z.string().optional(),
+    desc: z.string().optional(),
+});
+// Address schema
+export const addressSchema = z.object({
+    _class: z.literal("Address").optional(),
+    street: z.string().optional(),
+    locality: z.string().optional(),
+    city: z.string().optional(),
+    county: z.string().optional(),
+    state: z.string().optional(),
+    country: z.string().optional(),
+    postal: z.string().optional(),
+    phone: z.string().optional(),
+});
+// Place name schema
+export const placeNameSchema = z.object({
+    _class: z.literal("PlaceName").optional(),
+    value: z.string().optional(),
+    date: dateSchema,
+    lang: z.string().optional(),
+});
+// Gender schema
+export const genderSchema = z.enum(["male", "female", "unknown"]).transform((val) => {
+    switch (val) {
+        case "male":
+            return 1;
+        case "female":
+            return 0;
+        default:
+            return 2;
+    }
+});
+// Pagination schema
+export const paginationSchema = z.object({
+    page: z.number().int().positive().default(1).describe("Page number (1-indexed)"),
+    pagesize: z.number().int().positive().max(100).default(20).describe("Results per page (max 100)"),
+});
+//# sourceMappingURL=common.js.map

package/dist/schemas/common.js.map

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