@kakedashi/md-to-article-mcp 1.0.0

package/README.md

@@ -0,0 +1,96 @@
+# @kakedashi/md-to-article-mcp
+
+Markdown ファイルを読み込み、X Article エディタにペースト可能なリッチテキスト（`text/html`）としてクリップボードにコピーする MCP ツールです。
+
+## インストール
+
+### npx で使う（インストール不要）
+
+```bash
+npx @kakedashi/md-to-article-mcp
+```
+
+### グローバルインストール
+
+```bash
+npm install -g @kakedashi/md-to-article-mcp
+```
+
+## Claude Desktop への設定
+
+`claude_desktop_config.json` に以下を追加してください。
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "md-to-article": {
+      "command": "npx",
+      "args": ["-y", "@kakedashi/md-to-article-mcp"]
+    }
+  }
+}
+```
+
+グローバルインストール済みの場合:
+
+```json
+{
+  "mcpServers": {
+    "md-to-article": {
+      "command": "md-to-article-mcp"
+    }
+  }
+}
+```
+
+## 使い方
+
+Claude に以下のように依頼するだけです。
+
+```
+~/Desktop/my-article.md を X Article 用にクリップボードにコピーして
+```
+
+Claude が `md_to_article` ツールを呼び出し、変換後の HTML がクリップボードにコピーされます。
+その後、X Article エディタで **Cmd+V**（macOS）または **Ctrl+V**（Windows/Linux）でペーストしてください。
+
+### ツール仕様
+
+| 項目 | 内容 |
+|------|------|
+| ツール名 | `md_to_article` |
+| 引数 | `filepath` (string, 必須) — Markdown ファイルのパス |
+
+## 対応プラットフォーム
+
+| OS | クリップボード方法 | 必要なコマンド |
+|----|------------------|---------------|
+| macOS | `osascript` 経由で `«data HTML»` 形式でコピー | 標準搭載（追加インストール不要） |
+| Windows | PowerShell の `Set-Clipboard -AsHtml` | 標準搭載（追加インストール不要） |
+| Linux | `xclip -selection clipboard -t text/html` | `xclip` のインストールが必要 |
+
+### Linux での xclip インストール
+
+```bash
+# Ubuntu/Debian
+sudo apt install xclip
+
+# Fedora
+sudo dnf install xclip
+
+# Arch Linux
+sudo pacman -S xclip
+```
+
+## 変換仕様
+
+- **画像** (`![alt](url)`) → alt テキストのみに置換（画像は埋め込まれません）
+- **コードブロック** → プレーンテキストとして `<pre>` タグに変換
+- その他の Markdown 記法（見出し、太字、リンク、リストなど）は HTML に変換されます
+
+## ライセンス
+
+MIT

package/dist/clipboard.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyHtmlToClipboard = copyHtmlToClipboard;
+const child_process_1 = require("child_process");
+function copyHtmlToClipboard(html) {
+    const platform = process.platform;
+    if (platform === "darwin") {
+        copyHtmlMacOS(html);
+    }
+    else if (platform === "win32") {
+        copyHtmlWindows(html);
+    }
+    else {
+        copyHtmlLinux(html);
+    }
+}
+function copyHtmlMacOS(html) {
+    const hex = Buffer.from(html, "utf-8").toString("hex").toUpperCase();
+    const script = `set the clipboard to «data HTML${hex}»`;
+    (0, child_process_1.execSync)(`osascript -e '${script.replace(/'/g, "'\"'\"'")}'`);
+}
+function copyHtmlWindows(html) {
+    const escaped = html.replace(/"/g, '\\"');
+    (0, child_process_1.execSync)(`powershell -Command "Set-Clipboard -Value \\"${escaped}\\" -AsHtml"`, { shell: "powershell.exe" });
+}
+function copyHtmlLinux(html) {
+    (0, child_process_1.execSync)(`echo ${JSON.stringify(html)} | xclip -selection clipboard -t text/html`);
+}

package/dist/converter.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertMarkdownToHtml = convertMarkdownToHtml;
+const marked_1 = require("marked");
+function convertMarkdownToHtml(markdown) {
+    const renderer = new marked_1.Renderer();
+    // img タグは alt テキストのみに置換
+    renderer.image = (href, title, text) => {
+        return text ? text : "";
+    };
+    // pre/code ブロックはプレーンテキストにフォールバック
+    renderer.code = (code, _language) => {
+        return `<pre>${escapeHtml(code)}</pre>`;
+    };
+    renderer.codespan = (code) => {
+        return `<code>${escapeHtml(code)}</code>`;
+    };
+    return (0, marked_1.marked)(markdown, { renderer });
+}
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#039;");
+}

package/dist/index.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const converter_js_1 = require("./converter.js");
+const clipboard_js_1 = require("./clipboard.js");
+const server = new index_js_1.Server({ name: "md-to-article-mcp", version: "1.0.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "md_to_article",
+            description: "Markdown ファイルを読み込み、X Article エディタにペースト可能なリッチテキスト（text/html）としてクリップボードにコピーします",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filepath: {
+                        type: "string",
+                        description: "変換する Markdown ファイルのパス",
+                    },
+                },
+                required: ["filepath"],
+            },
+        },
+    ],
+}));
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    if (request.params.name !== "md_to_article") {
+        throw new Error(`Unknown tool: ${request.params.name}`);
+    }
+    const { filepath } = request.params.arguments;
+    const resolvedPath = path.resolve(filepath);
+    // ファイル読み込み
+    let markdown;
+    try {
+        markdown = fs.readFileSync(resolvedPath, "utf-8");
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `ファイルが見つかりません: ${resolvedPath}\n${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // HTML 変換
+    let html;
+    try {
+        html = (0, converter_js_1.convertMarkdownToHtml)(markdown);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Markdown の変換に失敗しました: ${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // クリップボードへコピー
+    try {
+        (0, clipboard_js_1.copyHtmlToClipboard)(html);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `クリップボードへのコピーに失敗しました: ${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: "クリップボードにコピーしました。X Article エディタで Cmd+V してください。",
+            },
+        ],
+    };
+});
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@kakedashi/md-to-article-mcp",
+  "version": "1.0.0",
+  "description": "MCP tool to convert Markdown files to rich text and copy to clipboard for X Article editor",
+  "main": "dist/index.js",
+  "bin": {
+    "md-to-article-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "markdown",
+    "clipboard",
+    "x-article"
+  ],
+  "author": "kakedashi",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "marked": "^4.3.0"
+  },
+  "devDependencies": {
+    "@types/marked": "^4.3.2",
+    "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2"
+  }
+}