MCP Unix Manual

🚀 Unix 手冊服務器 (MCP)

Unix 手冊服務器 (MCP) 可直接在 Claude 對話中提供 Unix 命令文檔，讓你無需在多個工具間切換，就能輕鬆獲取所需的命令信息。

🚀 快速開始

Unix 手冊服務器 (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

💻 使用示例

基礎用法

獲取命令文檔

我需要幫助使用 grep 命令。你能顯示相關文檔嗎？

列出常用命令

我的系統上有哪些可用的 Unix 命令？

檢查命令是否存在

awk 命令在我的系統上可用嗎？

📚 詳細文檔

開發

為了在不安裝到 Claude 的情況下本地測試服務器：

mcp dev unix_manual_server.py

安全性

該服務器通過以下方式預防命令注入：

• 對命令名稱進行正則表達式驗證。
• 直接執行命令而不使用 shell。
• 在所有命令執行上設置超時。
• 僅檢查文檔，從不執行任意命令。

日誌記錄

日誌保存到與腳本相同目錄的 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。