@kkingsbe/carto-art-mcp 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+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 { z } from "zod";
+import fetch from "node-fetch";
+const API_URL = process.env.CARTO_ART_API_URL || "http://localhost:3000/api/v1/posters/generate";
+const server = new Server({
+    name: "carto-art-mcp",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+const GeneratePosterArgumentsSchema = z.object({
+    location: z.string().describe("The location to center the map on (e.g., 'Paris, France')"),
+    style: z.string().optional().describe("The style ID (e.g., 'blueprint', 'retro', 'minimal')"),
+    zoom: z.number().optional().describe("The zoom level (1-20)"),
+    pitch: z.number().optional().describe("The pitch of the camera (0-60)"),
+    bearing: z.number().optional().describe("The bearing of the camera (0-360)"),
+    buildings_3d: z.boolean().optional().describe("Whether to enable 3D buildings"),
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "generate_poster",
+                description: "Generate a beautiful map poster for a given location and style.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        location: { type: "string", description: "The location (e.g., 'Paris, France')" },
+                        style: { type: "string", description: "The style ID (e.g., 'blueprint', 'retro', 'minimal')" },
+                        zoom: { type: "number", description: "The zoom level (1-20)" },
+                        pitch: { type: "number", description: "The pitch of the camera (0-60)" },
+                        bearing: { type: "number", description: "The bearing of the camera (0-360)" },
+                        buildings_3d: { type: "boolean", description: "Whether to enable 3D buildings" },
+                    },
+                    required: ["location"],
+                },
+            },
+        ],
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    if (request.params.name === "generate_poster") {
+        const args = GeneratePosterArgumentsSchema.parse(request.params.arguments);
+        try {
+            // 1. Geocode the location string
+            console.error(`Geocoding: ${args.location}`);
+            const geocodeBaseUrl = API_URL.replace("/posters/generate", "/geocode");
+            const geocodeResponse = await fetch(`${geocodeBaseUrl}?q=${encodeURIComponent(args.location)}&limit=1`, {
+                headers: { "Authorization": `Bearer ${process.env.CARTO_ART_API_KEY || "local-dev"}` }
+            });
+            if (!geocodeResponse.ok) {
+                throw new Error(`Geocoding failed: ${geocodeResponse.statusText}`);
+            }
+            const geocodeData = await geocodeResponse.json();
+            if (!geocodeData || geocodeData.length === 0) {
+                return {
+                    content: [{ type: "text", text: `Could not find location: ${args.location}` }],
+                    isError: true,
+                };
+            }
+            const { lat, lon } = geocodeData[0];
+            // 2. Prepare the payload for the new SimplifiedPosterSchema
+            const payload = {
+                location: {
+                    lat: parseFloat(lat),
+                    lng: parseFloat(lon)
+                },
+                style: args.style || "minimal",
+                camera: {
+                    pitch: args.pitch || 0,
+                    bearing: args.bearing || 0,
+                    zoom: args.zoom || 12,
+                },
+                options: {
+                    buildings_3d: args.buildings_3d || false,
+                    high_res: true,
+                }
+            };
+            console.error("Calling generation API with payload:", JSON.stringify(payload));
+            // 3. Call the generation API with Accept: image/png
+            const imageResponse = await fetch(API_URL, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "Accept": "image/png",
+                    "Authorization": `Bearer ${process.env.CARTO_ART_API_KEY || "local-dev"}`
+                },
+                body: JSON.stringify(payload),
+            });
+            if (!imageResponse.ok) {
+                const errorText = await imageResponse.text();
+                return {
+                    content: [{ type: "text", text: `Error from API: ${imageResponse.status} ${imageResponse.statusText}\n${errorText}` }],
+                    isError: true,
+                };
+            }
+            const buffer = await imageResponse.arrayBuffer();
+            const base64Image = Buffer.from(buffer).toString("base64");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Generated poster for ${args.location}.`,
+                    },
+                    {
+                        type: "image",
+                        data: base64Image,
+                        mimeType: "image/png",
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Failed to connect to CartoArt API: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    }
+    throw new Error("Tool not found");
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("CartoArt MCP server running on stdio");
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@kkingsbe/carto-art-mcp",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "carto-art-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "ts-node index.ts",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "node-fetch": "^3.3.2",
+    "zod": "^4.3.4"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}