MCP Unix Manual

🚀 Unix マニュアルサーバー (MCP)

この MCP サーバーは、Claude のチャットで直接 Unix コマンドのドキュメントを提供します。

✨ 主な機能

• コマンドドキュメントの取得：ヘルプページ、マニュアルページ、コマンドの使用情報を検索します。
• 一般的なコマンドの一覧表示：システム上で利用可能なコマンドを見つけ、機能別に分類して表示します。
• コマンドの存在確認：特定のコマンドが利用可能かどうかを確認し、バージョン情報を取得します。

📦 インストール

前提条件

• Python 3.13 以上
• Claude Desktop または MCP と互換性のある任意のクライアント

セットアップ

1. このリポジトリをクローンします。
2. パッケージをインストールします。

pip install -e .
# または
uv install -e .

3. Claude Desktop でサーバーをインストールします。

mcp install unix_manual_server.py
# uv 方式
uv run mcp install unix_manual_server.py

💻 使用例

基本的な使用法

インストールが完了したら、Claude 内で直接サーバーのツールを使用できます。

コマンドドキュメントの取得

私は grep コマンドの使い方が分からない。関連するドキュメントを表示してくれますか？

一般的なコマンドの一覧表示

私のシステムで利用可能な Unix コマンドは何ですか？

コマンドの存在確認

awk コマンドは私のシステムで利用可能ですか？

高度な使用法

Claude にインストールせずにサーバーをローカルでテストするには、以下のコマンドを実行します。

mcp dev unix_manual_server.py

🔧 技術詳細

セキュリティ

このサーバーは、以下の方法でコマンドインジェクションを防止しています。

• コマンド名を正規表現で検証する
• シェルを使用せずにコマンドを直接実行する
• すべてのコマンド実行にタイムアウトを設定する
• ドキュメントのみを確認し、任意のコマンドを実行しない

ログ記録

ログはスクリプトと同じディレクトリ内の unix - manual - server.log ファイルに保存され、デバッグが容易になります。

• @modelcontextprotocol/inspector を npx と組み合わせて使用する場合：

uv run mcp dev unix_manual_server.py

npx @modelcontextprotocol/inspector uv run unix_manual_server.py

📄 ライセンス

MIT

MCP Python SDK を使用して作成されました。MCP の詳細については、modelcontextprotocol.io をご覧ください。