@sgcarstrends/mcp 4.51.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 SG Cars Trends
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/client.d.ts

@@ -0,0 +1,6 @@
+export interface ApiResponse<T> {
+    ok: boolean;
+    status: number;
+    data: T;
+}
+export declare function request<T>(path: string, options?: RequestInit): Promise<ApiResponse<T>>;

package/dist/client.js

@@ -0,0 +1,26 @@
+import { withRelatedProject } from "@vercel/related-projects";
+const baseUrl = withRelatedProject({
+    projectName: "web",
+    defaultHost: "https://sgcarstrends.com",
+});
+const apiToken = process.env.SG_CARS_TRENDS_API_TOKEN;
+export async function request(path, options = {}) {
+    if (!apiToken) {
+        throw new Error("SG_CARS_TRENDS_API_TOKEN environment variable is not set");
+    }
+    const url = `${baseUrl}${path}`;
+    const response = await fetch(url, {
+        ...options,
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiToken}`,
+            ...options.headers,
+        },
+    });
+    const data = await response.json();
+    return {
+        ok: response.ok,
+        status: response.status,
+        data: data,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import * as z from "zod";
+import pkg from "../package.json" with { type: "json" };
+import { request } from "./client.js";
+function errorResult(response) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Error ${response.status}: ${JSON.stringify(response.data)}`,
+            },
+        ],
+        isError: true,
+    };
+}
+function jsonResult(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+const postBodySchema = {
+    title: z.string().min(1).describe("Post title"),
+    content: z.string().min(1).describe("Post content in MDX format"),
+    excerpt: z.string().optional().describe("Short excerpt/summary"),
+    heroImage: z.string().optional().describe("Hero image URL"),
+    tags: z.array(z.string()).optional().describe("Post tags"),
+    highlights: z
+        .array(z.object({
+        value: z.string(),
+        label: z.string(),
+        detail: z.string(),
+    }))
+        .optional()
+        .describe("Key highlights to display"),
+    month: z
+        .string()
+        .optional()
+        .describe("Data month (e.g. 2024-01) for deduplication"),
+    dataType: z
+        .string()
+        .optional()
+        .describe("Data type (e.g. cars, coe) for deduplication"),
+    status: z
+        .enum(["draft", "published"])
+        .default("draft")
+        .describe("Post status"),
+};
+const server = new McpServer({
+    name: pkg.name,
+    version: pkg.version,
+});
+server.tool("list_posts", "List blog posts with optional status filter and limit", {
+    status: z
+        .enum(["draft", "published"])
+        .optional()
+        .describe("Filter by post status"),
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .max(100)
+        .optional()
+        .describe("Maximum number of posts to return (default 50)"),
+}, async ({ status, limit }) => {
+    const params = new URLSearchParams();
+    if (status)
+        params.set("status", status);
+    if (limit)
+        params.set("limit", String(limit));
+    const query = params.toString();
+    const path = `/api/v1/posts${query ? `?${query}` : ""}`;
+    const response = await request(path);
+    if (!response.ok)
+        return errorResult(response);
+    return jsonResult(response.data);
+});
+server.tool("get_post", "Get a single blog post by its UUID", {
+    id: z.string().uuid().describe("The UUID of the post"),
+}, async ({ id }) => {
+    const response = await request(`/api/v1/posts/${id}`);
+    if (!response.ok)
+        return errorResult(response);
+    return jsonResult(response.data);
+});
+server.tool("create_post", "Create a new blog post", postBodySchema, async (input) => {
+    const response = await request("/api/v1/posts", {
+        method: "POST",
+        body: JSON.stringify(input),
+    });
+    if (!response.ok)
+        return errorResult(response);
+    return jsonResult(response.data);
+});
+server.tool("update_post", "Update an existing blog post", {
+    id: z.string().uuid().describe("The UUID of the post to update"),
+    ...postBodySchema,
+}, async ({ id, ...body }) => {
+    const response = await request(`/api/v1/posts/${id}`, {
+        method: "PUT",
+        body: JSON.stringify(body),
+    });
+    if (!response.ok)
+        return errorResult(response);
+    return jsonResult(response.data);
+});
+server.tool("delete_post", "Delete a blog post permanently", {
+    id: z.string().uuid().describe("The UUID of the post to delete"),
+}, async ({ id }) => {
+    const response = await request(`/api/v1/posts/${id}`, {
+        method: "DELETE",
+    });
+    if (!response.ok)
+        return errorResult(response);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Post ${id} deleted successfully.`,
+            },
+        ],
+    };
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@sgcarstrends/mcp",
+  "version": "4.51.1",
+  "description": "MCP server for SG Cars Trends blog post management",
+  "type": "module",
+  "bin": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sgcarstrends/sgcarstrends.git",
+    "directory": "apps/mcp"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@vercel/related-projects": "^1.0.0",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}