disk-clean-mcp 0.1.3 → 0.1.4

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 +138 -137
  2. package/package.json +51 -50
package/README.md CHANGED
@@ -1,11 +1,12 @@
1
1
  # Disk Clean MCP
2
+ mcp-name: io.github.superandyfre/disk-clean-mcp
2
3
 
3
4
  [![npm version](https://img.shields.io/npm/v/disk-clean-mcp?color=2e7d32)](https://www.npmjs.com/package/disk-clean-mcp)
4
5
  [![build](https://github.com/Superandyfre/disk-clean-mcp/actions/workflows/build.yml/badge.svg)](https://github.com/Superandyfre/disk-clean-mcp/actions/workflows/build.yml)
5
6
  [![license](https://img.shields.io/badge/license-MIT-0a0a0a.svg)](https://github.com/Superandyfre/disk-clean-mcp/blob/main/LICENSE)
6
7
  [![node](https://img.shields.io/badge/node-%3E%3D18-43853d.svg)](https://nodejs.org/en/)
7
8
 
8
- **Available Languages:** [English](#disk-clean-mcp) | [Fran?ais](#fr) | [��������](#zh-cn) | [���w����](#zh-tw) | [???](#ko) | [�ձ��Z](#ja)
9
+ **Available Languages:** [English](#disk-clean-mcp) | [Fran?ais](#fr) | [简体中文](#zh-cn) | [繁體中文](#zh-tw) | [???](#ko) | [日本語](#ja)
9
10
 
10
11
  ---
11
12
 
@@ -60,18 +61,18 @@ npm run dev
60
61
  ```
61
62
 
62
63
  ### Tools
63
- - **scan_summary** �C Get total size, file count, directory count with optional depth and ignore globs
64
- - **by_type** �C Top file extensions ranked by total size
65
- - **top_dirs** �C Heaviest subdirectories by aggregate size
66
- - **top_files** �C Largest files with filters (min size, age, glob include/exclude)
67
- - **stale_candidates** �C Large and old files (cleanup suggestions)
68
- - **duplicate_candidates** �C Groups of files with identical size and content hash (read-only)
69
-
70
- ### MCP Hub / Claude Submission (EN/����)
64
+ - **scan_summary** Get total size, file count, directory count with optional depth and ignore globs
65
+ - **by_type** Top file extensions ranked by total size
66
+ - **top_dirs** Heaviest subdirectories by aggregate size
67
+ - **top_files** Largest files with filters (min size, age, glob include/exclude)
68
+ - **stale_candidates** Large and old files (cleanup suggestions)
69
+ - **duplicate_candidates** Groups of files with identical size and content hash (read-only)
70
+
71
+ ### MCP Hub / Claude Submission (EN/中文)
71
72
  - Status: pending listing; add MCP Hub link after approval.
72
73
  - Provide when submitting: repo URL, npm install command (`npm install -g disk-clean-mcp` / `npx disk-clean-mcp`), command name (`disk-clean-mcp`), Node >= 18, MIT license, and the tool list above.
73
- - Config snippet (Claude Desktop): see ��Configuration for Claude Desktop�� JSON above.
74
- - ����Ҫ�㣺�ύʱ׼���ֿ����ӡ�npm ��װָ���������Node �汾Ҫ��MIT ���ɡ������嵥��Claude ����ʾ����
74
+ - Config snippet (Claude Desktop): see Configuration for Claude Desktop JSON above.
75
+ - 中文要点:提交时准备仓库链接、npm 安装指令、命令名、Node 版本要求、MIT 许可、工具清单、Claude 配置示例。
75
76
 
76
77
  ### Release Checklist
77
78
  - [ ] Run `npm run build` to verify compilation
@@ -82,7 +83,7 @@ npm run dev
82
83
  - [ ] Update repository URLs in package.json if needed
83
84
 
84
85
  ### License
85
- MIT �C Copyright (c) 2026 Superandyfre
86
+ MIT Copyright (c) 2026 Superandyfre
86
87
 
87
88
  ---
88
89
 
@@ -90,24 +91,24 @@ MIT
90
91
 
91
92
  ## Fran?ais
92
93
 
93
- Un serveur Model Context Protocol (MCP) qui analyse l'utilisation du disque local en mode lecture seule et sugg��re des cibles de nettoyage par taille, type, r��cence et doublons.
94
+ Un serveur Model Context Protocol (MCP) qui analyse l'utilisation du disque local en mode lecture seule et suggère des cibles de nettoyage par taille, type, récence et doublons.
94
95
 
95
- ### Fonctionnalit��s
96
- - **Analyse de r��pertoires**: Scannez les r��pertoires pour r��sumer la taille totale, le nombre de fichiers et r��pertoires avec limites de profondeur configurables et motifs glob.
97
- - **Analyse par extension**: D��composez l'utilisation du disque par extension de fichier pour identifier les types de fichiers les plus volumineux.
98
- - **Classement des r��pertoires**: Listez les sous-r��pertoires les plus volumineux par taille de fichier agr��g��e.
99
- - **D��tection de fichiers volumineux**: Trouvez les fichiers les plus volumineux avec filtres optionnels par taille, ?ge et motifs glob.
100
- - **Suggestions de fichiers obsol��tes**: Identifiez les fichiers volumineux et anciens pour nettoyage potentiel.
101
- - **D��tection des doublons**: Trouvez les groupes de fichiers avec tailles et hachages de contenu identiques (lecture seule).
102
- - **Limites configurables**: Utilisez `ignoreGlobs`, `includeGlobs`, `maxFiles` et `maxDepth` pour affiner la port��e.
96
+ ### Fonctionnalités
97
+ - **Analyse de répertoires**: Scannez les répertoires pour résumer la taille totale, le nombre de fichiers et répertoires avec limites de profondeur configurables et motifs glob.
98
+ - **Analyse par extension**: Décomposez l'utilisation du disque par extension de fichier pour identifier les types de fichiers les plus volumineux.
99
+ - **Classement des répertoires**: Listez les sous-répertoires les plus volumineux par taille de fichier agrégée.
100
+ - **Détection de fichiers volumineux**: Trouvez les fichiers les plus volumineux avec filtres optionnels par taille, ?ge et motifs glob.
101
+ - **Suggestions de fichiers obsolètes**: Identifiez les fichiers volumineux et anciens pour nettoyage potentiel.
102
+ - **Détection des doublons**: Trouvez les groupes de fichiers avec tailles et hachages de contenu identiques (lecture seule).
103
+ - **Limites configurables**: Utilisez `ignoreGlobs`, `includeGlobs`, `maxFiles` et `maxDepth` pour affiner la portée.
103
104
 
104
105
  ### Configuration requise
105
106
  - Node.js >= 18
106
- - Op��ration en lecture seule (pas de fonctions de suppression/d��placement)
107
- - Dossiers ignor��s par d��faut: `node_modules`, `.git`, `dist`, `build`, `.cache`
107
+ - Opération en lecture seule (pas de fonctions de suppression/déplacement)
108
+ - Dossiers ignorés par défaut: `node_modules`, `.git`, `dist`, `build`, `.cache`
108
109
 
109
110
  ### Installation et utilisation
110
- #### Paquet publi�� (recommand��)
111
+ #### Paquet publié (recommandé)
111
112
  ```bash
112
113
  npm install -g disk-clean-mcp
113
114
  # ou utiliser directement
@@ -127,7 +128,7 @@ npx disk-clean-mcp
127
128
  }
128
129
  ```
129
130
 
130
- #### D��veloppement local
131
+ #### Développement local
131
132
  ```bash
132
133
  git clone https://github.com/Superandyfre/disk-clean-mcp.git
133
134
  cd disk-clean-mcp
@@ -138,47 +139,47 @@ npm run dev # mode dev avec recompilation automatique
138
139
  ```
139
140
 
140
141
  ### Outils disponibles
141
- - **scan_summary** �C Obtenez la taille totale, le nombre de fichiers et r��pertoires
142
- - **by_type** �C Extensions de fichier class��es par taille totale
143
- - **top_dirs** �C Sous-r��pertoires les plus volumineux
144
- - **top_files** �C Fichiers les plus volumineux avec filtres
145
- - **stale_candidates** �C Fichiers volumineux et anciens
146
- - **duplicate_candidates** �C Groupes de fichiers doublons
142
+ - **scan_summary** Obtenez la taille totale, le nombre de fichiers et répertoires
143
+ - **by_type** Extensions de fichier classées par taille totale
144
+ - **top_dirs** Sous-répertoires les plus volumineux
145
+ - **top_files** Fichiers les plus volumineux avec filtres
146
+ - **stale_candidates** Fichiers volumineux et anciens
147
+ - **duplicate_candidates** Groupes de fichiers doublons
147
148
 
148
149
  ### Licence
149
- MIT �C Copyright (c) 2026 Superandyfre
150
+ MIT Copyright (c) 2026 Superandyfre
150
151
 
151
152
  ---
152
153
 
153
154
  <a id="zh-cn"></a>
154
155
 
155
- ## ��������
156
+ ## 简体中文
156
157
 
157
- һ�� Model Context Protocol (MCP) �����������ڷ������ش���ʹ�������ֻ��ģʽ����������С�����͡��¾ɳ̶Ⱥ��ظ��������Ŀ�ꡣ
158
+ 一个 Model Context Protocol (MCP) 服务器,用于分析本地磁盘使用情况(只读模式),并按大小、类型、新旧程度和重复项建议清理目标。
158
159
 
159
- ### ��������
160
- - **Ŀ¼ɨ��**: ɨ��Ŀ¼�Ի����ܴ�С���ļ�����Ŀ¼����֧�ֿ����õ�������ƺ�ȫ��ƥ��ģʽ��
161
- - **��չ������**: ���ļ���չ���ֽ����ʹ�������ʶ�������ļ����͡�
162
- - **Ŀ¼����**: ���ۺ��ļ���С�г�������Ŀ¼��
163
- - **���ļ����**: ���������ļ���֧�ְ���С�������ȫ��ģʽ���ˡ�
164
- - **�¾��ļ�����**: ʶ�������Ҫ�����Ĵ������Ͼɵ��ļ���
165
- - **�ظ�����**: ���Ҿ�����ͬ��С�����ݹ�ϣ���ļ��飨ֻ������
166
- - **����������**: ʹ�� `ignoreGlobs`��`includeGlobs`��`maxFiles` �� `maxDepth` ��������Χ�Ϳ��ƹ������ء�
160
+ ### 功能特性
161
+ - **目录扫描**: 扫描目录以汇总总大小、文件数和目录数,支持可配置的深度限制和全局匹配模式。
162
+ - **扩展名分析**: 按文件扩展名分解磁盘使用情况,识别最大的文件类型。
163
+ - **目录排名**: 按聚合文件大小列出最大的子目录。
164
+ - **大文件检测**: 查找最大的文件,支持按大小、年龄和全局模式过滤。
165
+ - **陈旧文件建议**: 识别可能需要清理的大型且老旧的文件。
166
+ - **重复项检测**: 查找具有相同大小和内容哈希的文件组(只读)。
167
+ - **可配置限制**: 使用 `ignoreGlobs`、`includeGlobs`、`maxFiles` `maxDepth` 来调整范围和控制工作负载。
167
168
 
168
- ### ϵͳҪ��
169
+ ### 系统要求
169
170
  - Node.js >= 18
170
- - ֻ����������ɾ��/�ƶ����ܣ�
171
- - Ĭ�Ϻ��Ե��ļ��У�`node_modules`��`.git`��`dist`��`build`��`.cache`
171
+ - 只读操作(无删除/移动功能)
172
+ - 默认忽略的文件夹:`node_modules`、`.git`、`dist`、`build`、`.cache`
172
173
 
173
- ### ��װ��ʹ��
174
- #### �ѷ����İ����Ƽ���
174
+ ### 安装与使用
175
+ #### 已发布的包(推荐)
175
176
  ```bash
176
177
  npm install -g disk-clean-mcp
177
- # ��ֱ��ʹ��
178
+ # 或直接使用
178
179
  npx disk-clean-mcp
179
180
  ```
180
181
 
181
- #### Claude Desktop ����ʾ��
182
+ #### Claude Desktop 配置示例
182
183
  ```json
183
184
  {
184
185
  "mcpServers": {
@@ -191,65 +192,65 @@ npx disk-clean-mcp
191
192
  }
192
193
  ```
193
194
 
194
- #### ���ؿ���
195
+ #### 本地开发
195
196
  ```bash
196
197
  git clone https://github.com/Superandyfre/disk-clean-mcp.git
197
198
  cd disk-clean-mcp
198
199
  npm install
199
200
  npm run build
200
201
  npm start
201
- npm run dev # ����ģʽ���Զ�����
202
+ npm run dev # 开发模式,自动编译
202
203
  ```
203
204
 
204
- ### �����б�
205
- - **scan_summary** �C ��ȡ�ܴ�С���ļ�����Ŀ¼����֧����Ⱥͺ���ģʽ
206
- - **by_type** �C ���ܴ�С���е��ļ���չ��
207
- - **top_dirs** �C ������Ŀ¼�����ۺϴ�С��
208
- - **top_files** �C �����ļ���֧�ֹ��ˣ���С�����䡢ģʽ��
209
- - **stale_candidates** �C �������Ͼɵ��ļ����������飩
210
- - **duplicate_candidates** �C �ظ��ļ��飨��ͬ��С�͹�ϣ��
205
+ ### 工具列表
206
+ - **scan_summary** 获取总大小、文件数、目录数,支持深度和忽略模式
207
+ - **by_type** 按总大小排列的文件扩展名
208
+ - **top_dirs** 最大的子目录(按聚合大小)
209
+ - **top_files** 最大的文件,支持过滤(大小、年龄、模式)
210
+ - **stale_candidates** 大型且老旧的文件(清理建议)
211
+ - **duplicate_candidates** 重复文件组(相同大小和哈希)
211
212
 
212
- ### ��������嵥
213
- - [ ] ���� `npm run build` ��֤����
214
- - [ ] ȷ�� Node.js >= 18
215
- - [ ] ���°汾��`npm version patch|minor|major`
216
- - [ ] ������ npm��`npm publish`����Ҫ npm ��¼��
217
- - [ ] ���� README �� CHANGELOG�������ã�
213
+ ### 发布检查清单
214
+ - [ ] 运行 `npm run build` 验证编译
215
+ - [ ] 确认 Node.js >= 18
216
+ - [ ] 更新版本:`npm version patch|minor|major`
217
+ - [ ] 发布到 npm:`npm publish`(需要 npm 登录)
218
+ - [ ] 更新 README CHANGELOG(如适用)
218
219
 
219
- ### ����֤
220
- MIT �C Copyright (c) 2026 Superandyfre
220
+ ### 许可证
221
+ MIT Copyright (c) 2026 Superandyfre
221
222
 
222
223
  ---
223
224
 
224
225
  <a id="zh-tw"></a>
225
226
 
226
- ## ���w����
227
+ ## 繁體中文
227
228
 
228
- һ�� Model Context Protocol (MCP) �ŷ�������춷������C�ŵ�ʹ����r��Ψ�xģʽ�����K����С����͡����f�̶Ⱥ����}헽��h����Ŀ�ˡ�
229
+ 一個 Model Context Protocol (MCP) 伺服器,用於分析本機磁碟使用情況(唯讀模式),並按大小、類型、新舊程度和重複項建議清理目標。
229
230
 
230
- ### ��������
231
- - **Ŀ䛒���**: ����Ŀ��ԏ�������С���n������Ŀ䛔���֧Ԯ���O����������ƺ�ͨ���䌦ģʽ��
232
- - **���n������**: ���n�����n���ֽ�ŵ�ʹ����r���R�e���ęn����͡�
233
- - **Ŀ�����**: ���ۺϙn����С�г�������Ŀ䛡�
234
- - **��n���ɜy**: �������ęn����֧Ԯ����С�����g��ͨ��ģʽ�Y�x��
235
- - **��f�n�����h**: �R�e������Ҫ�����Ĵ��������f�ęn����
236
- - **���}헂ɜy**: ���Ҿ�����ͬ��С�̓����s���ęn���M��Ψ�x����
237
- - **���O������**: ʹ�� `ignoreGlobs`��`includeGlobs`��`maxFiles` �� `maxDepth` ���{�������Ϳ��ƹ���ؓ�d��
231
+ ### 功能特性
232
+ - **目錄掃描**: 掃描目錄以彙總總大小、檔案數和目錄數,支援可設定的深度限制和通用配對模式。
233
+ - **副檔名分析**: 按檔案副檔名分解磁碟使用情況,識別最大的檔案類型。
234
+ - **目錄排名**: 按聚合檔案大小列出最大的子目錄。
235
+ - **大檔案偵測**: 查找最大的檔案,支援按大小、年齡和通用模式篩選。
236
+ - **陳舊檔案建議**: 識別可能需要清理的大型且老舊的檔案。
237
+ - **重複項偵測**: 查找具有相同大小和內容雜湊的檔案組(唯讀)。
238
+ - **可設定限制**: 使用 `ignoreGlobs`、`includeGlobs`、`maxFiles` `maxDepth` 來調整範圍和控制工作負載。
238
239
 
239
- ### ϵ�y����
240
+ ### 系統需求
240
241
  - Node.js >= 18
241
- - Ψ�x���I���o�h��/�Ƅӹ��ܣ�
242
- - �A�O���Ե��Y�ϊA��`node_modules`��`.git`��`dist`��`build`��`.cache`
242
+ - 唯讀作業(無刪除/移動功能)
243
+ - 預設忽略的資料夾:`node_modules`、`.git`、`dist`、`build`、`.cache`
243
244
 
244
- ### ���b�cʹ��
245
- #### �Ѱl�ѵ��׼������]��
245
+ ### 安裝與使用
246
+ #### 已發佈的套件(推薦)
246
247
  ```bash
247
248
  npm install -g disk-clean-mcp
248
- # ��ֱ��ʹ��
249
+ # 或直接使用
249
250
  npx disk-clean-mcp
250
251
  ```
251
252
 
252
- #### Claude Desktop �O������
253
+ #### Claude Desktop 設定範例
253
254
  ```json
254
255
  {
255
256
  "mcpServers": {
@@ -262,26 +263,26 @@ npx disk-clean-mcp
262
263
  }
263
264
  ```
264
265
 
265
- #### ���C�_�l
266
+ #### 本機開發
266
267
  ```bash
267
268
  git clone https://github.com/Superandyfre/disk-clean-mcp.git
268
269
  cd disk-clean-mcp
269
270
  npm install
270
271
  npm run build
271
272
  npm start
272
- npm run dev # �_�lģʽ���ԄӾ��g
273
+ npm run dev # 開發模式,自動編譯
273
274
  ```
274
275
 
275
- ### �������
276
- - **scan_summary** �C ȡ�ÿ���С���n������Ŀ䛔���֧Ԯ��Ⱥͺ���ģʽ
277
- - **by_type** �C ������С���еęn�����n��
278
- - **top_dirs** �C ������Ŀ䛣����ۺϴ�С��
279
- - **top_files** �C ���ęn����֧Ԯ�Y�x����С�����g��ģʽ��
280
- - **stale_candidates** �C ���������f�ęn�����������h��
281
- - **duplicate_candidates** �C ���}�n���M����ͬ��С���s����
276
+ ### 工具清單
277
+ - **scan_summary** 取得總大小、檔案數、目錄數,支援深度和忽略模式
278
+ - **by_type** 按總大小排列的檔案副檔名
279
+ - **top_dirs** 最大的子目錄(按聚合大小)
280
+ - **top_files** 最大的檔案,支援篩選(大小、年齡、模式)
281
+ - **stale_candidates** 大型且老舊的檔案(清理建議)
282
+ - **duplicate_candidates** 重複檔案組(相同大小和雜湊)
282
283
 
283
- ### �ڙ�
284
- MIT �C Copyright (c) 2026 Superandyfre
284
+ ### 授權
285
+ MIT Copyright (c) 2026 Superandyfre
285
286
 
286
287
  ---
287
288
 
@@ -337,47 +338,47 @@ npm run dev # ?? ???? ?? ?? ??
337
338
  ```
338
339
 
339
340
  ### ??
340
- - **scan_summary** �C ? ??, ?? ?, ???? ? ??
341
- - **by_type** �C ? ???? ??? ?? ???
342
- - **top_dirs** �C ?? ???? ?? ? ?? ????
343
- - **top_files** �C ??? ?? ?? ? ??(??, ??, ??)
344
- - **stale_candidates** �C ?? ??? ??(?? ??)
345
- - **duplicate_candidates** �C ?? ?? ??(??? ?? ? ??)
341
+ - **scan_summary** ? ??, ?? ?, ???? ? ??
342
+ - **by_type** ? ???? ??? ?? ???
343
+ - **top_dirs** ?? ???? ?? ? ?? ????
344
+ - **top_files** ??? ?? ?? ? ??(??, ??, ??)
345
+ - **stale_candidates** ?? ??? ??(?? ??)
346
+ - **duplicate_candidates** ?? ?? ??(??? ?? ? ??)
346
347
 
347
348
  ### ????
348
- MIT �C Copyright (c) 2026 Superandyfre
349
+ MIT Copyright (c) 2026 Superandyfre
349
350
 
350
351
  ---
351
352
 
352
353
  <a id="ja"></a>
353
354
 
354
- ## �ձ��Z
355
+ ## 日本語
355
356
 
356
- ���`����ǥ�������ʹ��״�r���i��ȡ�ꌟ�å�`�ɤǷ��������������������ס������ԡ���������}�ˤ�äƥ���`�󥢥å׌�����᰸����Model Context Protocol��MCP�����`�Щ`�Ǥ���
357
+ ローカルディスクの使用状況を読み取り専用モードで分析し、サイズ、タイプ、最新性、および重複によってクリーンアップ対象を提案するModel Context ProtocolMCP)サーバーです。
357
358
 
358
- ### �C��
359
- - **�ǥ��쥯�ȥꥹ�����**: �ǥ��쥯�ȥ�򥹥���󤷤ơ���Ӌ���������ե����������ǥ��쥯�ȥ�����Ҫ�s���ޤ������ɿ��ܤ�������ޤȥ����֥ѥ��`��򥵥ݩ`�Ȥ��ޤ���
360
- - **��������**: �ե����뒈���ӄe�˥ǥ�����ʹ������ֽ⤷�����Υե����륿���פ��R�e���ޤ���
361
- - **�ǥ��쥯�ȥ��󥭥�**: ��Ӌ�ե����륵�����e�����Υ��֥ǥ��쥯�ȥ��һ�E��ʾ���ޤ���
362
- - **�󤭤ʥե�����ʳ�**: �����������h�������֥ѥ��`��ǥե��륿��󥰿��ܤ����Υե������������ޤ���
363
- - **�Ť��ե�������᰸**: ����`�󥢥åפΌ���Ȥʤ�����Ԥ�����󤭤��ƹŤ��ե�������R�e���ޤ���
364
- - **���}�ʳ�**: ͬ���������ȥ���ƥ�ĥϥå����֤ĥե����륰��`�פ�������ޤ����i��ȡ�ꌟ�ã���
365
- - **���ɿ��ܤ�����**: `ignoreGlobs`��`includeGlobs`��`maxFiles`��`maxDepth`��ʹ�ä��ƥ����`�פ��{�����ޤ���
359
+ ### 機能
360
+ - **ディレクトリスキャン**: ディレクトリをスキャンして、合計サイズ、ファイル数、ディレクトリ数を要約します。構成可能な深度制限とグロブパターンをサポートします。
361
+ - **拡張分析**: ファイル拡張子別にディスク使用量を分解し、最大のファイルタイプを識別します。
362
+ - **ディレクトリランキング**: 集計ファイルサイズ別に最大のサブディレクトリを一覧表示します。
363
+ - **大きなファイル検出**: サイズ、年齢、グロブパターンでフィルタリング可能な最大のファイルを検索します。
364
+ - **古いファイルの提案**: クリーンアップの対象となる可能性がある大きくて古いファイルを識別します。
365
+ - **重複検出**: 同じサイズとコンテンツハッシュを持つファイルグループを検索します(読み取り専用)。
366
+ - **構成可能な制限**: `ignoreGlobs`、`includeGlobs`、`maxFiles`、`maxDepth`を使用してスコープを調整します。
366
367
 
367
- ### Ҫ��
368
+ ### 要件
368
369
  - Node.js >= 18
369
- - �i��ȡ�ꌟ�ò���������/�ƄәC�ܤʤ���
370
- - �ǥե���Ȥǟoҕ�����ե����: `node_modules`��`.git`��`dist`��`build`��`.cache`
370
+ - 読み取り専用操作(削除/移動機能なし)
371
+ - デフォルトで無視されるフォルダ: `node_modules`、`.git`、`dist`、`build`、`.cache`
371
372
 
372
- ### ���󥹥ȩ`���ʹ��
373
- #### ���_�ѥå��`�����ƊX��
373
+ ### インストールと使用
374
+ #### 公開パッケージ(推奨)
374
375
  ```bash
375
376
  npm install -g disk-clean-mcp
376
- # �ޤ���ֱ��ʹ��
377
+ # または直接使用
377
378
  npx disk-clean-mcp
378
379
  ```
379
380
 
380
- #### Claude Desktop�O����
381
+ #### Claude Desktop設定例
381
382
  ```json
382
383
  {
383
384
  "mcpServers": {
@@ -390,36 +391,36 @@ npx disk-clean-mcp
390
391
  }
391
392
  ```
392
393
 
393
- #### ���`�����_�k
394
+ #### ローカル開発
394
395
  ```bash
395
396
  git clone https://github.com/Superandyfre/disk-clean-mcp.git
396
397
  cd disk-clean-mcp
397
398
  npm install
398
399
  npm run build
399
400
  npm start
400
- npm run dev # �Ԅӥ���ѥ��븶�����_�k��`��
401
+ npm run dev # 自動コンパイル付きの開発モード
401
402
  ```
402
403
 
403
- ### �ĩ`��
404
- - **scan_summary** �C ��Ӌ���������ե����������ǥ��쥯�ȥ�����ȡ��
405
- - **by_type** �C ��Ӌ�������e�˥��`�Ȥ��줿�ե����뒈����
406
- - **top_dirs** �C ��Ӌ�������e�����Υ��֥ǥ��쥯�ȥ�
407
- - **top_files** �C �ե��륿���������ե����루�����������h���ѥ��`��
408
- - **stale_candidates** �C �󤭤��ƹŤ��ե����루����`�󥢥å��᰸��
409
- - **duplicate_candidates** �C ���}�ե����륰��`�ף�ͬ���������ȥϥå��壩
404
+ ### ツール
405
+ - **scan_summary** 合計サイズ、ファイル数、ディレクトリ数を取得
406
+ - **by_type** 合計サイズ別にソートされたファイル拡張子
407
+ - **top_dirs** 集計サイズ別に最大のサブディレクトリ
408
+ - **top_files** フィルタ付きの最大ファイル(サイズ、年齢、パターン)
409
+ - **stale_candidates** 大きくて古いファイル(クリーンアップ提案)
410
+ - **duplicate_candidates** 重複ファイルグループ(同じサイズとハッシュ)
410
411
 
411
- ### �饤����
412
- MIT �C Copyright (c) 2026 Superandyfre
413
- - ���� README/CHANGELOG ���иĶ�
414
- - �� package.json �е� repository / bugs / homepage �滻Ϊʵ�ʲֿ��ַ
412
+ ### ライセンス
413
+ MIT Copyright (c) 2026 Superandyfre
414
+ - 更新 README/CHANGELOG 如有改动
415
+ - package.json 中的 repository / bugs / homepage 替换为实际仓库地址
415
416
 
416
417
  ## Tools
417
- - `scan_summary` �C total size/files/dirs, optional depth and ignore globs.
418
- - `by_type` �C top extensions by total size.
419
- - `top_dirs` �C heaviest subdirectories.
420
- - `top_files` �C largest files with filters (min size, age, glob include/exclude).
421
- - `stale_candidates` �C large and old files.
422
- - `duplicate_candidates` �C groups of files with identical sizes and hashes (read-only).
418
+ - `scan_summary` total size/files/dirs, optional depth and ignore globs.
419
+ - `by_type` top extensions by total size.
420
+ - `top_dirs` heaviest subdirectories.
421
+ - `top_files` largest files with filters (min size, age, glob include/exclude).
422
+ - `stale_candidates` large and old files.
423
+ - `duplicate_candidates` groups of files with identical sizes and hashes (read-only).
423
424
 
424
425
  ## Notes
425
426
  - Read-only: no delete/move operations.
package/package.json CHANGED
@@ -1,50 +1,51 @@
1
- {
2
- "name": "disk-clean-mcp",
3
- "version": "0.1.3",
4
- "description": "A Model Context Protocol server that analyzes local disk usage and suggests cleanup targets.",
5
- "private": false,
6
- "type": "module",
7
- "license": "MIT",
8
- "main": "dist/index.js",
9
- "bin": {
10
- "disk-clean-mcp": "dist/index.js"
11
- },
12
- "files": [
13
- "dist"
14
- ],
15
- "engines": {
16
- "node": ">=18"
17
- },
18
- "keywords": [
19
- "mcp",
20
- "disk",
21
- "cleanup",
22
- "filesystem",
23
- "scan",
24
- "cli"
25
- ],
26
- "repository": {
27
- "type": "git",
28
- "url": "git+https://github.com/Superandyfre/disk-clean-mcp.git"
29
- },
30
- "bugs": {
31
- "url": "https://github.com/Superandyfre/disk-clean-mcp/issues"
32
- },
33
- "homepage": "https://github.com/Superandyfre/disk-clean-mcp#readme",
34
- "scripts": {
35
- "build": "tsc -p tsconfig.json",
36
- "start": "node dist/index.js",
37
- "dev": "ts-node src/index.ts"
38
- },
39
- "dependencies": {
40
- "@modelcontextprotocol/sdk": "^1.25.1",
41
- "micromatch": "^4.0.7",
42
- "zod": "^3.24.1"
43
- },
44
- "devDependencies": {
45
- "@types/micromatch": "^4.0.8",
46
- "@types/node": "^20.11.30",
47
- "ts-node": "^10.9.2",
48
- "typescript": "^5.3.3"
49
- }
50
- }
1
+ {
2
+ "name": "disk-clean-mcp",
3
+ "version": "0.1.4",
4
+ "mcpName": "io.github.Superandyfre/disk-clean-mcp",
5
+ "description": "A Model Context Protocol server that analyzes local disk usage and suggests cleanup targets.",
6
+ "private": false,
7
+ "type": "module",
8
+ "license": "MIT",
9
+ "main": "dist/index.js",
10
+ "bin": {
11
+ "disk-clean-mcp": "dist/index.js"
12
+ },
13
+ "files": [
14
+ "dist"
15
+ ],
16
+ "engines": {
17
+ "node": ">=18"
18
+ },
19
+ "keywords": [
20
+ "mcp",
21
+ "disk",
22
+ "cleanup",
23
+ "filesystem",
24
+ "scan",
25
+ "cli"
26
+ ],
27
+ "repository": {
28
+ "type": "git",
29
+ "url": "git+https://github.com/Superandyfre/disk-clean-mcp.git"
30
+ },
31
+ "bugs": {
32
+ "url": "https://github.com/Superandyfre/disk-clean-mcp/issues"
33
+ },
34
+ "homepage": "https://github.com/Superandyfre/disk-clean-mcp#readme",
35
+ "scripts": {
36
+ "build": "tsc -p tsconfig.json",
37
+ "start": "node dist/index.js",
38
+ "dev": "ts-node src/index.ts"
39
+ },
40
+ "dependencies": {
41
+ "@modelcontextprotocol/sdk": "^1.25.1",
42
+ "micromatch": "^4.0.7",
43
+ "zod": "^3.24.1"
44
+ },
45
+ "devDependencies": {
46
+ "@types/micromatch": "^4.0.8",
47
+ "@types/node": "^20.11.30",
48
+ "ts-node": "^10.9.2",
49
+ "typescript": "^5.3.3"
50
+ }
51
+ }