Mcp Unix Manual

MCP Unix Manual

Claude 内で Unix のマニュアルページに直接アクセスできる Model Context Protocol（MCP）サーバーです。会話から離れることなく、man ページを検索したり、ドキュメントを調べたり、Unix コマンドを確認したりできます。

機能

• マニュアルページの読み込み：任意の Unix man ページの全文を取得します
• ドキュメントの検索：apropos を使ってキーワードからコマンドを探します
• セクションの閲覧：標準的な Unix マニュアルページのセクションを確認します
• macOS ネイティブ：macOS で最適なパフォーマンスを発揮するよう Swift で構築されています

利用可能なツール

ツール	説明	パラメーター
read_manpage	Unix のマニュアルページを読み込みます	command（必須）、section（任意）
search_manpages	キーワードで man ページを検索します	query（必須）
list_man_sections	標準的なマニュアルセクションを一覧表示します	なし

使用例

Claude, can you read the man page for grep?
Claude, search for commands related to "network"
Claude, show me the list of manual sections

必要条件

• macOS 13.0 以降
• Swift 6.2 以降
• Xcode（ビルド用）

インストール

1. サーバーをビルドする

リポジトリをクローンして、リリース版をビルドします。

git clone <repository-url>
cd MCPUnixManual
swift build -c release

実行ファイルは .build/release/mcp-unix-manual に作成されます。

2. Claude Desktop を設定する

ステップ 1：設定ファイルを確認する

Claude Desktop の設定ファイルを開きます。

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

ファイルが存在しない場合は、作成します。

mkdir -p ~/Library/Application\ Support/Claude
touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

ステップ 2：MCP サーバーを追加する

claude_desktop_config.json に次の設定を追加します。

{
  "mcpServers": {
    "unix-manual": {
      "command": "/absolute/path/to/MCPUnixManual/.build/release/mcp-unix-manual"
    }
  }
}

重要：/absolute/path/to/MCPUnixManual を、クローンしたリポジトリの実際の絶対パスに置き換えてください。

絶対パスを確認するには、プロジェクトディレクトリで次のコマンドを実行します。

pwd

次に、そのパスを設定に使用します。例：

{
  "mcpServers": {
    "unix-manual": {
      "command": "/Users/yourname/Projects/MCPUnixManual/.build/release/mcp-unix-manual"
    }
  }
}

ステップ 3：Claude Desktop を再起動する

変更を反映するには、Claude Desktop を完全に終了してから再起動します。

ステップ 4：統合を確認する

Claude Desktop を開き、右下にある MCP アイコン（🔌）を探します。クリックして利用可能な MCP サーバーを表示し、「unix-manual」が一覧にあることを確認してください。

これで、Claude に Unix マニュアルのツールを使うよう依頼できます。

• 「ls の man ページを読んで」
• 「プロセスに関連するコマンドを検索して」
• 「Unix のマニュアルセクションを教えて」

トラブルシューティング

MCP サーバーが表示されない場合：

• claude_desktop_config.json に記載したパスが絶対パスであり、正しいことを確認してください
• 実行ファイルに実行権限があることを確認してください：chmod +x .build/release/mcp-unix-manual
• Claude Desktop を完全に再起動したことを確認してください

権限エラーが発生する場合：

• 実行ファイルがビルドされ、アクセス可能であることを確認してください
• エラーを確認するため、実行ファイルを直接実行してみてください：.build/release/mcp-unix-manual

JSON 構文エラーが発生する場合：

• claude_desktop_config.json の構文を検証してください
• JSON に末尾のカンマがないことを確認してください

Claude Code との統合

Claude Code（CLI）の場合は、MCP 設定ファイルに次の内容を追加します。

{
  "mcpServers": {
    "unix-manual": {
      "command": "/absolute/path/to/MCPUnixManual/.build/release/mcp-unix-manual"
    }
  }
}

開発

開発モードで実行する

swift run mcp-unix-manual

テストを実行する

swift test

プロジェクト構成

MCPUnixManual/
├── Package.swift              # Swift package manifest
├── Sources/
│   └── MCPUnixManual/
│       └── MCP.swift         # Main server implementation
└── README.md

セキュリティ

この MCP サーバーは、Unix のマニュアルページを取得するためにシェルコマンド（man、apropos）を実行します。コマンドインジェクションを防ぐため、入力の検証を行います。

• コマンド名には英数字、ピリオド、ハイフン、アンダースコアのみ使用できます
• 実行前に引数を適切にエスケープします
• コマンドは Claude Desktop と同じ権限で実行されます

プラットフォームのサポート

• macOS：完全にサポートされています（Foundation.Process を使用）
• iOS/tvOS/watchOS/visionOS：コンパイルできますが、エラーメッセージを返します（Process は利用できません）

これは意図的な仕様です。Unix のマニュアルページは macOS でのみ利用できます。

ライセンス

[ライセンスをここに追加してください]

コントリビューション

コントリビューションを歓迎します。お気軽にイシューやプルリクエストを送信してください。

クレジット

Anthropic の MCP Swift SDK を使用して構築されています。