Unix Manual Server (MCP)

基本能力

产品定位

mcp-unix-manual 是一个专门用于查询 Unix 命令文档的 MCP 服务器，旨在为开发者和系统管理员提供便捷的命令查询服务。

核心功能

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

适用场景

• 开发过程中快速查询 Unix 命令用法
• 系统管理时了解可用命令及其功能
• 学习 Unix 命令时获取详细文档

工具列表

• 命令文档查询工具：提供完整的 Unix 命令文档
• 命令列表工具：列出系统上可用的命令
• 命令检查工具：验证命令是否存在并获取版本信息

常见问题解答

• 安全性：服务器采取多项措施防止命令注入，包括验证命令名称、不使用 shell 直接执行命令、设置执行超时等
• 日志记录：日志保存在脚本同目录下的 unix-manual-server.log 文件中，便于调试

使用教程

使用依赖

• Python 3.13+
• Claude Desktop 或任何兼容 MCP 的客户端

安装教程

1. 克隆仓库
2. 安装包：

pip install -e .
# 或
uv install -e .

1. 在 Claude Desktop 中安装服务器：

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

调试方式

要在不安装到 Claude 的情况下本地测试服务器：

mcp dev unix_manual_server.py

或者使用 inspector：

uv run mcp dev unix_manual_server.py

npx @modelcontextprotocol/inspector uv run unix_manual_server.py

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。