星战科技xingzhan.cloud
返回市场
克劳德狂暴模式

克劳德狂暴模式

作者：theaj422 星标更新：2025-06-26
安装使用来源：spider==github.com

项目介绍

Claude桌面环境设置 - 一键安装

创建一个预配置的Claude桌面环境，包含用于高效AI协作的基本MCP服务器。

概述

此安装程序弥合了复杂AI自动化与主流易用性之间的差距。用户无需花费数小时探索和配置MCP服务器，只需一条命令即可获得一个运行良好的、高效的设置。

您将获得的内容

核心MCP服务器Pod

  • 命令行访问（CLI）：直接执行系统命令
  • 文件系统：范围内的文件操作和管理
  • 内存：跨会话的持久知识图谱
  • 时间：时间感知和调度
  • 日历：Apple日历集成
  • Git：版本控制操作

组织的工作空间

/Users/username/ClaudeDesktop/
├── projects/    （初始化Git以进行开发）
├── documents/   （通用文档存储）
├── scripts/     （初始化Git以进行自动化）
└── logs/        （系统和错误日志）

智能配置管理

  • 非破坏性安装（备份现有配置）
  • 智能配置合并
  • 简单回滚和故障排除
  • 通过文件系统访问进行AI辅助问题解决

快速开始

先决条件

  • macOS（Windows/Linux支持将在后续阶段提供）
  • 已安装Claude桌面
  • Python 3 和 Node.js

安装

⚠️ 重要安全警告 ⚠️

此安装程序赋予Claude以下能力：

  • 在指定目录中创建、修改和删除文件
  • 执行系统命令（如果启用CLI访问）
  • 对文件系统进行永久更改

仅在您对Claude拥有这些功能感到舒适时才进行安装。始终维护重要数据的备份。

# 克隆仓库
git clone https://github.com/theaj42/Claude_BeestMode.git
cd Claude_BeestMode

# 运行安装程序
./install.sh

安装程序将：

  1. 检查您的系统和现有的Claude桌面安装
  2. 查询关于文件系统访问偏好的信息
  3. 备份当前配置
  4. 安装并配置核心MCP服务器
  5. 创建组织的工作空间结构
  6. 验证完整的设置

安装后

  1. 重启Claude桌面以加载新的配置
  2. 测试设置：询问Claude“我有哪些可用的MCP服务器？”
  3. 浏览您的工作空间：“我的ClaudeDesktop目录里有什么？”
  4. 开始协作：“帮我组织一个新的项目”

这有何不同

对于用户

  • 无需技术探索 - 从第一天起就具有生产力
  • 精选服务器 - 必要工具，无冗余
  • 引导式入门 - 清晰的下一步步骤和使用示例
  • 安全第一 - 非破坏性安装，易于回滚

对于开发者

  • 模块化架构 - 易于扩展和定制
  • 跨平台基础 - 计划支持Windows/Linux
  • 全面验证 - 自动测试和健康检查
  • 社区友好 - 清晰的贡献指南

架构

安装策略

  • 使用Shell脚本方法以实现最大兼容性
  • 模块化的平台特定实现
  • 同时管理Python（uvx）和Node.js（npx）服务器的依赖项
  • 智能配置合并，带有备份/恢复功能

MCP服务器选择

核心服务器被选中以实现最大的生产力影响：

  • CLI + 文件系统：直接系统交互
  • 内存：跨会话的持久上下文
  • 时间 + 日历：时间感知和调度
  • Git：版本控制集成

安全性和范围

  • 文件系统访问限制在指定的工作空间内
  • 用户控制额外的目录权限
  • 所有操作记录以确保问责
  • Git仓库跟踪所有更改

高级用法

手动服务器管理

# 安装额外的MCP服务器
./scripts/macos/install-mcp-servers.sh python your-server-name

# 备份当前配置
./scripts/macos/backup-config.sh backup

# 验证安装健康状况
./scripts/common/validation-functions.sh health

工作空间管理

# 设置自定义工作空间位置
./scripts/macos/setup-filesystem.sh /your/custom/path

# 验证工作空间结构
./scripts/macos/setup-filesystem.sh /your/path validate

故障排除

# 完整系统验证
./scripts/common/validation-functions.sh complete

# 快速健康检查
./scripts/common/validation-functions.sh health

# 测试MCP连接
./scripts/common/validation-functions.sh mcp

故障排除

常见问题

未找到Claude桌面

uvx不可用

  • 使用pip3 install uvx安装

权限错误

  • 确保用户对配置目录具有写入权限

MCP服务器未加载

  • 安装后重启Claude桌面
  • 使用./scripts/macos/backup-config.sh validate检查配置

获取帮助

  1. 查看常见问题解答：常见问题
  2. 查看日志：~/claude-desktop-setup.log
  3. 运行验证：./scripts/common/validation-functions.sh complete
  4. 询问Claude：通过文件系统访问，Claude可以直接帮助解决问题

开发路线图

第一阶段：核心安装系统 ✅ 完成

  • macOS安装脚本
  • MCP服务器自动化
  • 配置备份/合并
  • 目录结构创建
  • 全面验证框架

第二阶段：知识库及文档 ✅ 完成

  • 预配置的知识图谱（8个系统实体）
  • 包含故障排除的安装指南
  • 包含实际示例的使用指南
  • 最佳实践文档
  • AI辅助故障排除框架

第三阶段：验证与测试（准备开始）

  • 自动化安装后验证脚本
  • 互动测试对话优化
  • 自动健康检查系统
  • 用户入门对话模板

第四阶段：平台扩展

  • Windows安装脚本
  • Linux安装脚本
  • 跨平台兼容性测试
  • 平台特定文档

第五阶段：完善与发布

  • GitHub仓库连接
  • 视频演示
  • 社区测试版
  • 发布准备和公告

贡献

欢迎贡献！特别有价值的领域包括：

  • Windows/Linux支持 - 将脚本适应其他平台
  • 额外的MCP服务器 - 筛选有价值的服务器以供包含
  • 文档 - 截图、示例、故障排除指南
  • 测试 - 不同系统配置下的验证

技术细节

支持的平台

  • macOS（当前）
  • Windows（计划第四阶段）
  • Linux（计划第四阶段）

依赖项

  • Python 3.8+（用于uvx和Python MCP服务器）
  • Node.js 16+（用于Node.js MCP服务器）
  • Git（用于仓库初始化）
  • jq（可选，用于JSON验证）

配置位置

  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json

默认工作空间

  • ~/ClaudeDesktop/（安装期间可自定义）

许可

MIT许可 - 详情参见LICENSE文件。

有任何疑问？ 打开一个问题或直接询问Claude - 通过文件系统访问，Claude可以帮助您解决问题并改进设置！