Mcp Unix Manual

MCP Unix 手册

一个模型上下文协议（MCP）服务，可在 Claude 中直接访问 Unix 手册页。无需离开对话，即可查询 man 手册页、搜索文档并探索 Unix 命令。

功能

• 阅读手册页：获取任意 Unix man 手册页的全文
• 搜索文档：使用 apropos 按关键字查找命令
• 浏览章节：探索 Unix 标准手册页章节
• 原生支持 macOS：使用 Swift 构建，在 macOS 上实现最佳性能

可用工具

工具	描述	参数
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（命令行），将以下内容添加到 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 服务会执行 Shell 命令（man、apropos）来获取 Unix 手册页。为防止命令注入，会执行输入验证：

• 命令名称仅允许使用字母数字字符、句点、连字符和下划线
• 执行前会正确转义参数
• 命令以与 Claude Desktop 相同的权限运行

平台支持

• macOS：完全支持（使用 Foundation.Process）
• iOS/tvOS/watchOS/visionOS：可以编译，但会返回错误消息（Process 不可用）

这是有意为之——Unix 手册页仅在 macOS 上可用。

许可证

[在此添加你的许可证]

贡献

欢迎贡献！欢迎提交问题或拉取请求。

致谢

由 Anthropic 提供的 MCP Swift SDK 构建。