Claude Hands 项目使用教程

1. 项目目录结构及介绍

Claude Hands 项目是一个开源项目，旨在使用 Claude Desktop 和 MCP (Model Control Protocol) 重现 Manus 的实现。项目目录结构如下：

claude_hands/
├── assets/                     # 资源文件目录
├── docker/                     # Docker 配置文件目录
├── prompts/                    # 提示文件目录
├── scripts/                    # 脚本文件目录
│   ├── auto_approve            # 自动批准脚本
├── .env.sample                 # 环境变量配置样例文件
├── .gitignore                  # Git 忽略文件
├── LICENSE                     # 项目许可证文件
├── README.ja.md                # 日文 README 文件
├── README.md                   # 项目说明文件
├── chatgpt_mcp_agent.config.yaml # ChatGPT MCP 代理配置文件
├── claude_desktop_config.json  # Claude Desktop 配置文件
└── docker-compose.yml          # Docker Compose 配置文件

• assets/: 存放项目所需的资源文件。
• docker/: 包含 Docker 相关的配置文件。
• prompts/: 包含项目使用的提示文件。
• scripts/: 存放项目相关的脚本文件，例如自动批准脚本。
• .env.sample: 提供了环境变量配置的样例。
• .gitignore: 指定 Git 忽略的文件和目录。
• LICENSE: 项目使用的许可证信息。
• README.ja.md: 日文的项目说明文件。
• README.md: 项目说明文件。
• chatgpt_mcp_agent.config.yaml: ChatGPT MCP 代理的配置文件。
• claude_desktop_config.json: Claude Desktop 的配置文件。
• docker-compose.yml: 定义和运行多容器 Docker 应用程序的配置文件。

2. 项目的启动文件介绍

项目的启动主要通过 docker-compose.yml 文件来管理。这个文件定义了项目所需的服务，以及如何启动这些服务。

启动项目时，需要在项目根目录下运行以下命令：

docker-compose up -d

这条命令会做以下事情：

• 拉取所需的 Docker 镜像（如果尚未可用）。
• 启动 Claude Code 和 Tavily 服务。
• 将服务配置在指定的端口上运行。

3. 项目的配置文件介绍

项目中有两个主要的配置文件：.env.sample 和 claude_desktop_config.json。

• .env.sample: 这个文件提供了项目所需环境变量的样例配置。在使用前，需要将其复制为 .env 文件，并根据实际情况填写相应的值，如 Tavily API 密钥和 workspace 路径。

样例配置如下：

TAVILY_API_KEY=your_tavily_api_key_here
WORKSPACE_PATH=/path/to/your/workspace

• claude_desktop_config.json: 这个文件是 Claude Desktop 的配置文件，需要将其复制到 Claude Desktop 的配置目录下，然后重启 Claude Desktop。这样，你就可以通过 Claude Desktop 使用 MCP 服务器了。

以上是 Claude Hands 项目的目录结构、启动文件和配置文件的介绍。按照这些说明操作，你就可以开始使用这个项目了。