Unix 手册服务器 (MCP)

一个 MCP 服务器，可以直接在 Claude 对话中提供 Unix 命令文档。

功能

• 获取命令文档: 检索 Unix 命令的帮助页面、man 手册和用法信息
• 列出常用命令: 发现系统上可用的命令，按功能分类
• 检查命令是否存在: 验证特定命令是否可用并获取其版本信息

安装

前提条件

• 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

安全

服务器采取预防措施来防止命令注入，方法是：

• 根据正则表达式模式验证命令名称
• 直接执行命令而不使用 shell
• 设置所有命令执行的超时
• 仅检查文档，从不执行任意命令

日志

日志保存在与脚本相同的目录中的 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。