Unix Manual Server (MCP)

Unix Manual Server (MCP)

Claude の会話内で Unix コマンドのドキュメントを直接提供する MCP サーバーです。

特徴

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

インストール

前提条件

• Python 3.13+
• Claude Desktop または MCP 対応クライアント

セットアップ

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

pip install -e .
# or
uv install -e .

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

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

使用方法

インストール後、Claude でサーバーのツールを直接使用できます：

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

I need help with the grep command. Can you show me the documentation?

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

What Unix commands are available on my system?

コマンドが存在するか確認

Is the awk command available on my system?

開発

Claude にインストールせずにサーバーをローカルでテストするには：

mcp dev unix_manual_server.py

セキュリティ

サーバーは、コマンドインジェクションを防ぐために次の対策を講じています：

• コマンド名を正規表現パターンと照合して検証します
• シェルを使わずにコマンドを直接実行します
• すべてのコマンド実行にタイムアウトを設定します
• ドキュメントの確認のみを行い、任意のコマンドは実行しません

ロギング

ログはスクリプトと同じディレクトリにある unix-manual-server.log に保存され、デバッグに役立ちます。

• 内部では、npx とともに @modelcontextprotocol/inspector を使用します。

uv run mcp dev unix_manual_server.py

npx @modelcontextprotocol/inspector uv run unix_manual_server.py

ライセンス

MIT

---

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