🚀 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。