@kakedashi/md-to-article-mcp 1.0.5 → 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +66 -57
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,27 +1,16 @@
1
1
  # @kakedashi/md-to-article-mcp
2
2
 
3
- Markdown ファイルを読み込み、X Article エディタにペースト可能なリッチテキスト(`text/html`)としてクリップボードにコピーする MCP ツールです。
3
+ Markdown ファイルを X Article エディタにペースト可能なリッチテキストとしてクリップボードにコピーする CLI / MCP ツール。
4
4
 
5
- ## インストール
6
-
7
- ### npx で使う(インストール不要)
5
+ ## インストール不要で使える
8
6
 
9
7
  ```bash
10
- npx @kakedashi/md-to-article-mcp
8
+ npx @kakedashi/md-to-article-mcp /絶対パス/draft.md
11
9
  ```
12
10
 
13
- ### グローバルインストール
14
-
15
- ```bash
16
- npm install -g @kakedashi/md-to-article-mcp
17
- ```
11
+ ## Claude Desktop(MCP)として使う
18
12
 
19
- ## Claude Desktop への設定
20
-
21
- `claude_desktop_config.json` に以下を追加してください。
22
-
23
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
24
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
13
+ `claude_desktop_config.json` に追記:
25
14
 
26
15
  ```json
27
16
  {
@@ -34,63 +23,83 @@ npm install -g @kakedashi/md-to-article-mcp
34
23
  }
35
24
  ```
36
25
 
37
- グローバルインストール済みの場合:
26
+ config の場所:
27
+ - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
28
+ - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
29
+
30
+ Claude Desktop を再起動後、チャットで話しかける:
38
31
 
39
- ```json
40
- {
41
- "mcpServers": {
42
- "md-to-article": {
43
- "command": "md-to-article-mcp"
44
- }
45
- }
46
- }
47
32
  ```
33
+ /Users/あなたのユーザー名/Downloads/draft.md を X Article 用にクリップボードにコピーして
34
+ ```
35
+
36
+ ※ `~` は展開されないため絶対パスで指定してください。
37
+ ユーザー名の確認: `echo $HOME`
48
38
 
49
39
  ## 使い方
50
40
 
51
- Claude に以下のように依頼するだけです。
41
+ 1. npx でクリップボードにコピー
42
+ 2. X の Article エディタを Chrome で開く
43
+ 3. 本文エリアで Cmd+V
52
44
 
53
- ```
54
- ~/Desktop/my-article.md を X Article 用にクリップボードにコピーして
55
- ```
45
+ ## 対応要素
56
46
 
57
- Claude `md_to_article` ツールを呼び出し、変換後の HTML がクリップボードにコピーされます。
58
- その後、X Article エディタで **Cmd+V**(macOS)または **Ctrl+V**(Windows/Linux)でペーストしてください。
47
+ | 要素 | 対応 |
48
+ |---|---|
49
+ | 見出し h1 / h2 | ✅ |
50
+ | 太字 / イタリック | ✅ |
51
+ | 箇条書き / 番号付きリスト | ✅ |
52
+ | リンク | ✅ |
53
+ | 引用 | ✅ |
54
+ | コードブロック | ⚠️ プレーンテキストで挿入・手動で再設定が必要 |
55
+ | テーブル | ❌ X Article 非対応 |
56
+ | 画像 | ❌ alt テキストのみ残る |
59
57
 
60
- ### ツール仕様
58
+ ## 対応 OS
61
59
 
62
- | 項目 | 内容 |
63
- |------|------|
64
- | ツール名 | `md_to_article` |
65
- | 引数 | `filepath` (string, 必須) — Markdown ファイルのパス |
60
+ | OS | 方法 |
61
+ |---|---|
62
+ | macOS | osascript(AppleScript)|
63
+ | Windows | PowerShell Set-Clipboard |
64
+ | Linux | xclip |
66
65
 
67
- ## 対応プラットフォーム
66
+ ## Claude Code との連携
68
67
 
69
- | OS | クリップボード方法 | 必要なコマンド |
70
- |----|------------------|---------------|
71
- | macOS | `osascript` 経由で `«data HTML»` 形式でコピー | 標準搭載(追加インストール不要) |
72
- | Windows | PowerShell の `Set-Clipboard -AsHtml` | 標準搭載(追加インストール不要) |
73
- | Linux | `xclip -selection clipboard -t text/html` | `xclip` のインストールが必要 |
68
+ `CLAUDE.md` に以下を追記すると「x用にコピー」の一言で実行できる:
74
69
 
75
- ### Linux での xclip インストール
70
+ ```markdown
71
+ ## X Article へのコピー
72
+ 「x用にコピー」「article にして」などと言われたら、
73
+ 現在作業中の .md ファイルを特定して以下を実行してください:
74
+ npx @kakedashi/md-to-article-mcp {絶対パス}/{ファイル名}.md
75
+ ```
76
76
 
77
- ```bash
78
- # Ubuntu/Debian
79
- sudo apt install xclip
77
+ ## 動作環境
80
78
 
81
- # Fedora
82
- sudo dnf install xclip
79
+ | 環境 | バージョン |
80
+ |---|---|
81
+ | Node.js | >= 18 |
82
+ | npm | >= 9 |
83
83
 
84
- # Arch Linux
85
- sudo pacman -S xclip
86
- ```
84
+ ## Claude Code での使い方
87
85
 
88
- ## 変換仕様
86
+ プロジェクトの `CLAUDE.md` に以下を追記するだけ。
87
+
88
+ ---
89
+
90
+ ## X Article へのコピー
91
+
92
+ 「x用にコピー」「article にして」などと言われたら、
93
+ 現在作業中の .md ファイルを特定して以下を実行してください:
94
+
95
+ ```bash
96
+ npx @kakedashi/md-to-article-mcp {絶対パスに解決したファイル名}.md
97
+ ```
89
98
 
90
- - **画像** (`![alt](url)`) → alt テキストのみに置換(画像は埋め込まれません)
91
- - **コードブロック** → プレーンテキストとして `<pre>` タグに変換
92
- - その他の Markdown 記法(見出し、太字、リンク、リストなど)は HTML に変換されます
99
+ ---
93
100
 
94
- ## ライセンス
101
+ 追記後、Claude Code で以下のように話しかけるだけで動く:
95
102
 
96
- MIT
103
+ - 「x用にコピー」
104
+ - 「draft.md を article にして」
105
+ - 「これをX記事用にコピーして」
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kakedashi/md-to-article-mcp",
3
- "version": "1.0.5",
3
+ "version": "1.0.7",
4
4
  "description": "MCP tool to convert Markdown files to rich text and copy to clipboard for X Article editor",
5
5
  "main": "dist/index.js",
6
6
  "bin": {