🦚 PEACOCK MCP SERVER 🦚
孔雀是什么？
Peacock是一个自定义的模型上下文协议（MCP）服务器，它为Claude Desktop提供 完全文件系统访问和命令执行 您系统上的功能。
⚡️ 第一个！ 这是Claude Desktop推出的最早的Linux MCP服务器之一！
大音符 这是我能得到的最大的！
不要用这个 如果你不知道自己在做什么，或者至少不知道如何从安装此软件或用此软件破坏系统中恢复。你用这个弄坏了你妻子的电脑吗。不要用这个弄坏任何人的电脑。我很乐意回答任何问题。
我不负责 因为随之而来的任何混乱或快乐的魔法。世界必须明白，在操作任何计算机时都必须认真对待安全问题。话虽如此，有些人不应该得到烤面包机的钥匙！也不应该给他们其他破坏性的东西，比如手榴弹、电脑、人工智能或反情报。
为什么是“孔雀”？\ 因为AI想要炫耀！ 🦚
______________________________________________________________________
选择你自己的冒险🦚
🍎 macOS（索诺玛+）
已知与以下人员合作： macOS Sonoma及更高版本
cd peacock
./install_mac.sh🐧 Linux（CosmicTosh）
已知与以下人员合作： CosmicTosh（基于Debian的定制Linux发行版，运行在ZFS之上）
🥪 超级孔雀！
🎲 混合 -OpenCore macOS（索诺玛）与Archlinux（madOS）配对
\*\*目前正在运行dualboot OC Sonoma+madOS，这是我即将推出的发行版，不会固执己见！
cd peacock
./install.sh______________________________________________________________________
特性
- ✅ 读/写文件 -完全文件系统访问
- ✅ 执行命令 -直接运行bash命令
- ✅ 目录列表 -浏览您的文件系统
- ✅ 文件搜索 -查找具有glob模式的文件
- ✅ 文件简介 -获取详细的文件元数据
- ✅ 安全 -默认情况下仅限于主目录
______________________________________________________________________
配置
将此添加到 ~/.config/Claude/claude_desktop_config.json:
{
"mcpServers": {
"peacock": {
"command": "python3",
"args": [
"/full/path/to/peacock/peacock_server.py"
]
}
}
}替换 /full/path/to/peacock/ 与实际路径！
______________________________________________________________________
可用工具
read_file(path)
读取文件的内容。
例子： read_file("/home/rich/.bashrc") （Linux）\ 例子： read_file("/Users/rich/.bashrc") （macOS）
write_file(path, content, mode="w")
将内容写入文件。
例子： write_file("/home/rich/test.txt", "Hello World!")
list_directory(path=".", show_hidden=False)
列出目录的内容。
例子： list_directory("/home/rich", show_hidden=True)
execute_command(command, cwd=None)
执行shell命令。
例子： execute_command("ls -la", cwd="/home/rich")
search_files(pattern, directory=".", max_results=50)
搜索与模式匹配的文件。
例子： search_files("*.py", directory="/home/rich")
get_file_info(path)
获取文件的详细信息。
例子： get_file_info("/home/rich/.bashrc")
______________________________________________________________________
安全
- 默认限制： 所有操作仅限于用户的主目录
- 命令超时： 最大执行时间为30秒
- 没有root访问权限： 以用户身份运行，而不是以root身份运行
要更改基本目录，请编辑 BASE_DIR 在 peacock_server.py.
______________________________________________________________________
测试
手动测试服务器：
python3 peacock_server.py您应该看到：
🦚 PEACOCK MCP SERVER 🦚
📁 Base directory: /home/directory
🚀 Starting server...______________________________________________________________________
故障排除
“ModuleNotFoundError:没有名为'mcp'的模块”
macOS： 运行： pip3 install fastmcp\ Linux： 运行： pip3 install --break-system-packages fastmcp
“权限被拒绝”
确保脚本可执行： chmod +x peacock_server.py
Claude Desktop看不到Peacock
- 检查配置文件语法（必须是有效的JSON）
- 完全重新启动克劳德桌面
- 检查克劳德桌面日志：
~/.config/Claude/logs/
______________________________________________________________________
投资组合使用
该项目展示了：
- MCP协议 实施
- AI 代理 是可能的，并且可以同时确保安全
- python 异步编程
- 系统集成 在人工智能和macOS/Linux之间
- 安全 最佳实践
- 文档 技能
- 跨平台 支持
______________________________________________________________________
积分
建造人：
- 里奇·诺尔斯
适用于：
- 埃米特（未来🎮)
______________________________________________________________________
关于名称和徽标
名称 孔雀 之所以被选中，是因为。..这很有道理，谁不喜欢一只好孔雀呢？ 🦚
该标志旨在代表优雅和美丽。..
同时为这一成就感到自豪和谦卑。
______________________________________________________________________
许可证
MIT许可证