mcp-server-markview 1.2.5 → 1.2.7

package/README.md

@@ -29,37 +29,27 @@ The binary is downloaded automatically during installation. If the download fail
 
 ## Claude Code Configuration
 
-Add to your Claude Code MCP config (usually `~/.claude/mcp.json` or via `claude mcp add`):
+The easiest way — run once in your terminal:
 
-```json
-{
-  "mcpServers": {
-    "markview": {
-      "command": "npx",
-      "args": ["-y", "mcp-server-markview"]
-    }
-  }
-}
+```bash
+claude mcp add --transport stdio --scope user markview -- npx mcp-server-markview
 ```
 
-Or if you have installed it globally:
+This writes to `~/.claude.json` (user scope — works across all projects). Restart Claude Code after adding.
+
+Or add manually to `~/.claude.json` (permissions go in settings.json — MCP config goes here):
 
 ```json
 {
   "mcpServers": {
     "markview": {
-      "command": "mcp-server-markview"
+      "command": "npx",
+      "args": ["mcp-server-markview"]
     }
   }
 }
 ```
 
-### Using `claude mcp add`
-
-```bash
-claude mcp add markview -- npx -y mcp-server-markview
-```
-
 ## Available Tools
 
 ### `preview_markdown`

package/index.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * index.js — Smithery capability scanning entry point.
+ *
+ * Two modes:
+ *   1. Imported by Smithery: exports createSandboxServer() — returns a mock MCP
+ *      server with tool definitions. No binary spawned, works on any platform.
+ *   2. Run directly (main): proxies to the native MarkView MCP binary via stdio.
+ */
+"use strict";
+
+const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
+const {
+  ListToolsRequestSchema,
+} = require("@modelcontextprotocol/sdk/types.js");
+
+const VERSION = "1.2.7";
+
+const TOOLS = [
+  {
+    name: "preview_markdown",
+    description:
+      "Render a markdown string in MarkView's native macOS preview window. " +
+      "Supports GFM, Mermaid diagrams, code syntax highlighting (Prism.js), " +
+      "tables, task lists, and all CommonMark extensions.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        content: {
+          type: "string",
+          description: "Markdown source text to preview",
+        },
+        title: { type: "string", description: "Optional window title" },
+      },
+      required: ["content"],
+    },
+  },
+  {
+    name: "open_file",
+    description:
+      "Open an existing markdown file from disk in MarkView. " +
+      "The file must exist and have a markdown extension (.md, .markdown).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Absolute path to the .md file" },
+      },
+      required: ["path"],
+    },
+  },
+];
+
+/**
+ * Sandbox server for Smithery capability scanning.
+ * Returns a mock MCP server that responds to tools/list without spawning the Swift binary.
+ */
+function createSandboxServer() {
+  const server = new Server(
+    { name: "markview", version: VERSION },
+    { capabilities: { tools: {} } },
+  );
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: TOOLS,
+  }));
+  return server;
+}
+
+module.exports = { createSandboxServer };
+module.exports.default = createSandboxServer;
+
+// Stdio entrypoint — only spawns the native binary when run directly.
+if (require.main === module) {
+  const { spawn } = require("child_process");
+  const { resolve } = require("path");
+  const binary = resolve(__dirname, "bin/mcp-server-markview");
+  const child = spawn(binary, process.argv.slice(2), {
+    stdio: "inherit",
+    env: process.env,
+  });
+  child.on("exit", (code) => process.exit(code != null ? code : 0));
+  child.on("error", (err) => {
+    process.stderr.write("MarkView MCP server error: " + err.message + "\n");
+    process.exit(1);
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-server-markview",
-  "version": "1.2.5",
+  "version": "1.2.7",
   "description": "MCP server for MarkView — preview Markdown files in a native macOS viewer",
   "license": "MIT",
   "author": "Paul Kang <contact@paulkang.dev>",
@@ -13,6 +13,7 @@
   "bugs": {
     "url": "https://github.com/paulhkang94/markview/issues"
   },
+  "main": "index.js",
   "bin": {
     "mcp-server-markview": "bin/mcp-server-markview"
   },
@@ -21,6 +22,7 @@
     "postinstall": "node scripts/postinstall.js"
   },
   "files": [
+    "index.js",
     "bin/",
     "scripts/",
     "README.md"
@@ -38,11 +40,7 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "os": [
-    "darwin"
-  ],
-  "cpu": [
-    "arm64",
-    "x64"
-  ]
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1"
+  }
 }

package/scripts/postinstall.js

@@ -22,9 +22,12 @@ const { execFileSync } = require("child_process");
 
 const GITHUB_OWNER = "paulhkang94";
 const GITHUB_REPO = "markview";
-const VERSION = "1.2.5";
-const ARCHIVE_NAME = `MarkView-${VERSION}.tar.gz`;
-const DOWNLOAD_URL = `https://github.com/${GITHUB_OWNER}/${GITHUB_REPO}/releases/download/v${VERSION}/${ARCHIVE_NAME}`;
+// BINARY_VERSION pins the macOS app release to download.
+// This is intentionally decoupled from the npm package version —
+// npm patches (JS-only changes) don't require a new macOS binary release.
+const BINARY_VERSION = "1.2.6";
+const ARCHIVE_NAME = `MarkView-${BINARY_VERSION}.tar.gz`;
+const DOWNLOAD_URL = `https://github.com/${GITHUB_OWNER}/${GITHUB_REPO}/releases/download/v${BINARY_VERSION}/${ARCHIVE_NAME}`;
 
 // Path inside the tar.gz where the MCP server binary lives
 const BINARY_IN_ARCHIVE = `MarkView.app/Contents/MacOS/markview-mcp-server`;
@@ -148,7 +151,9 @@ async function main() {
   const archivePath = path.join(tmpDir, ARCHIVE_NAME);
 
   try {
-    console.log(`[mcp-server-markview] Downloading MarkView v${VERSION}...`);
+    console.log(
+      `[mcp-server-markview] Downloading MarkView v${BINARY_VERSION}...`,
+    );
     console.log(`  ${DOWNLOAD_URL}`);
 
     await downloadFile(DOWNLOAD_URL, archivePath);