Kilnshell について
Kilnshellは、エージェントにターミナル、ファイル、検索、プロセス、PDF、Excel、Wordのツールを提供するローカルMCPサーバーです。テレメトリーをなくし、バッチ実行や待機ツールで呼び出し回数を減らしつつ、Desktop Commander互換のツールと設定を維持します。
主な機能
- 01コマンド実行とプロセス管理
- 02ファイルの読み書きと編集
- 03ripgrepによるコード検索
- 04PDF、Excel、Wordの操作
- 05呼び出しの一括実行と条件待機
- 06ディレクトリとコマンド制限の設定
活用シーン
- 01エージェントからターミナル作業を実行
- 02プロジェクトファイルを検索・編集
- 03プロセス終了やファイル準備を待機
- 04オフィス文書を読み取り・編集
MCP 対応
KilnshellはClaude Desktop、Claude Code、CursorなどのMCPクライアントにローカルマシンのツールを提供します。クライアントはローカルサーバーとして接続し、リモートモードには対応していません。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
待たせることなく、マシン全体をAIエージェントで使えます。
MCP 経由で、ターミナル、ファイル、コード検索、長時間実行プロセス、PDF、Excel、Wordを利用できます。
Desktop Commanderのすべての機能を、呼び出しごとに最大100倍高速で利用できます。テレメトリーはなく、エージェントのコンテキストに何も注入されません。
ベンチマーク
| ツール呼び出し | Desktop Commander 0.3.1 | Kilnshell | 高速化 |
|---|---|---|---|
コマンドを実行(echo hi) | 696.7 ms | 5.7 ms | 122x |
コマンドを実行(git --version) | 703.7 ms | 16.2 ms | 43x |
| 2万行のファイルから1,000行を読み取り | 41.9 ms | 3.2 ms | 13x |
1行を編集(edit_block) | 75.7 ms | 6.9 ms | 11x |
| ファイルを書き込み | 34.7 ms | 1.0 ms | 35x |
| ファイル情報 | 21.8 ms | 1.2 ms | 18x |
| ディレクトリを一覧表示 | 19.2 ms | 1.4 ms | 14x |
| ファイルを10個まとめて読み取り | 191.8 ms | 3.5 ms | 55x |
MacBook Pro(Apple Silicon)、macOS、一般的な開発者向けプロファイル(Homebrewとnvm)を設定したzsh、Node 25を使用し、実際のMCP stdio経由で9回呼び出した中央値です。Desktop Commanderの設定ではテレメトリーを無効にしています。コマンドの高速化はシェルプロファイルによって異なり、プロファイルが重いほど効果が大きくなります。プロファイルを設定していないLinuxマシンでは、コマンドは約3倍、ファイルツールは3〜6倍高速です。
お使いのマシンで再現するには:
git clone https://github.com/Soflutionltd/kilnshell && cd kilnshell
npm install
npm run bench # installs Desktop Commander 0.3.1 next to it, runs both, redraws the chart
変更点と高速化の理由
Kilnshell は Desktop Commander 0.3.1 のクローンとして始まり、呼び出しごとにプロファイルされました。
- シェルのプロファイルはコマンドごとではなく、一度だけ読み込まれます。 Desktop Commander は各コマンドを
zsh -l -c ...として起動するため、nvm、pyenv、Homebrew を読み込むプロファイルでは、コマンドごとに 0.5〜1 秒かかります。Kilnshell は起動時にログインプロファイルを一度実行し、生成された環境(同じPATH、同じ変数)を保持して、各コマンドをzsh -cで起動します。毎回新しいログインシェルを使うには、DESKTOP_COMMANDER_LOGIN_ENV_CACHE=0を設定してください。 - 呼び出しのたびに、裏でプロセスが起動されることはありません。 テレメトリーはツール呼び出しごとにシステムレポートを再構築していたため、テレメトリーがオフでも、同期的に
python3 --versionを実行し、サーバーを 10〜25 ms の間停止させていました。システム情報は一度だけ計算されるようになりました。 - 行数カウントにはネイティブの文字列スキャンを使用します。 ファイルの読み取り、編集、検査では、文字を一つずつ数えて行数を算出していました。新しいカウント方法でも結果は同一(ランダムな入力 200,000 件で確認済み)で、大きなファイルでは約 11 倍高速です。
- デバッグログのノイズがありません。 以前は各呼び出しで、
[FEEDBACK DEBUG]ログ通知が 2〜4 件クライアントに送られていました。 - ラウンドトリップが減ります。 エージェントにとって、ツール呼び出しごとに完全なラウンドトリップが必要となり、多くの場合、その時間はコマンド自体の実行時間を大きく上回ります。Kilnshell には次の機能が追加されています。
batch:複数のツール呼び出し(コマンド、読み取り、編集、検索)を 1 回のリクエストにまとめ、結果を順番に番号付けして返します。wait_for_exit: trueを指定したread_process_output:ポーリングの代わりに、プロセスの終了を待って出力全体を一度に返します。wait: trueを指定したstart_search:start_searchの後にget_more_search_resultsを呼び出す代わりに、すべての結果を 1 回の呼び出しで返します。wait_for:スリープを繰り返す代わりに、ポートが接続を受け付ける、ファイルが存在する、URL が応答する、またはプロセスが終了するまで待機します。
- Claude Desktop 内でも最高速度で動作します。 Claude Desktop は拡張機能を独自の Node で実行しますが、環境は
env -0で取得されるため、そこでプロファイルキャッシュも機能し、Claude のELECTRON_*変数がコマンドに渡ることもありません。
削除された機能
| 上流版の動作 | Kilnshell |
|---|---|
| 使用状況のテレメトリーを Desktop Commander サーバーに送信 | 削除しました。Kilnshell が独自にネットワークへ接続することはありません。 |
| 5 分ごとに desktopcommander.app から機能フラグをダウンロード | 組み込みのデフォルト値のみです(独自にホストする場合は KILNSHELL_FLAG_URL を指定します)。 |
ツールの結果に [SYSTEM INSTRUCTION] テキストを追加し、モデルにフィードバックの依頼や Docker セットアップの宣伝を促す | 削除しました。ツールの結果にはツールの出力だけが含まれます。 |
| 初回実行時にブラウザーで開くウェルカムページ | 削除しました。 |
give_feedback_to_desktop_commander ツール | 非表示です。 |
remote モード(Desktop Commander のクラウドサービスに依存) | 利用できません。 |
それ以外はすべて同じコードです。同じツール、同じ引数、同じ設定ファイル(~/.claude-server-commander/config.json)を使用するため、Kilnshell はそのまま置き換えて使用できます。新しいツールとオプションは追加のみです。
インストール
Claude Desktop: kilnshell.mcpb をダウンロードしてダブルクリックします(または、Settings > Extensions > Advanced settings > Install Extension を選択します)。すると、すべてのツール呼び出しの横に Kilnshell のアイコンが表示されます。
Claude Code: /plugin install kilnshell --marketplace Soflutionltd/kilnshell
公式の MCP Registry にも com.soflution/kilnshell として掲載されています。
Cursor または任意の MCP クライアント:
{
"mcpServers": {
"kilnshell": {
"command": "npx",
"args": ["-y", "github:Soflutionltd/kilnshell"]
}
}
}
または、ローカルクローンから実行します。npx よりも高速に起動します。
git clone https://github.com/Soflutionltd/kilnshell && cd kilnshell && npm install
{ "mcpServers": { "kilnshell": { "command": "node", "args": ["/absolute/path/to/kilnshell/dist/index.js"] } } }
ツール
| 領域 | ツール |
|---|---|
| 速度 | batch(複数の呼び出しをまとめて実行)、wait_for(ポート、ファイル、URL、プロセス) |
| ターミナル | start_process、interact_with_process、read_process_output(wait_for_exit)、list_sessions、list_processes、force_terminate、kill_process |
| ファイル | read_file、read_multiple_files、write_file、edit_block、create_directory、list_directory、move_file、get_file_info |
| 検索 | start_search(wait)、get_more_search_results、stop_search、list_searches(ripgrep) |
| ドキュメント | write_pdf、さらに read_file、write_file、edit_block による PDF、Excel、Word ファイルの読み取りと編集 |
| 設定 | get_config、set_config_value、get_usage_stats、get_recent_tool_calls |
セキュリティ制御に変更はありません。allowedDirectories、blockedCommands、ファイルの読み取りと書き込みの行数制限は、すべて設定ファイルで管理されます。
開発
npm install
npm run build
npm test # the full upstream test suite (takes several minutes)
npm run bench # Kilnshell vs Desktop Commander on this machine
クレジットとライセンス
Kilnshell は Eduard Ruzga と Desktop Commander のコントリビューターによる Desktop Commander を基盤としており、MIT ライセンスで公開されています。完全な履歴はこのリポジトリに保持されています。Kilnshell は独立したプロジェクトであり、彼らと提携しておらず、彼らの推奨を受けているものでもありません。
MIT、© 2024-2025 Eduard Ruzga and Desktop Commander Contributors、© 2026 Soflution Ltd。LICENSE をご覧ください。
フランス語で
Kilnshell は、AI エージェントがターミナル、ファイル、コード検索、プロセス、PDF、Excel、Word など、あなたのマシンにアクセスできるようにする MCP サーバーです。Desktop Commander のクローンであり、呼び出しごとに最適化されています。開発者向け Mac で最大 100 倍高速で、テレメトリーは一切なく、エージェントへの応答に広告文が挿入されることもありません。Claude の設定で 1 行変更するだけで置き換えられます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。