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

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