feat: 添加启动脚本和更新文档

- 新增启动脚本 `start.sh`，自动化 Neo4j 初始化和 MCP 服务器启动流程
- 更新 `.dockerignore` 文件以包含必要的文件
- 修改 `Dockerfile` 以复制并设置启动脚本权限
- 更新 `MCP_USAGE.md` 和 `README.md`，详细说明启动脚本的使用和功能

Author: vaenow

.dockerignore

@@ -5,6 +5,14 @@
 # Documentation
 README.md
 *.md
+!MCP_USAGE.md
+
+# Include essential files
+!start.sh
+!mcp_server.py
+!main.py
+!requirements.txt
+!env.example
 
 # Docker
 Dockerfile*

Dockerfile

@@ -36,68 +36,13 @@ RUN mkdir -p /var/lib/neo4j/data /var/lib/neo4j/logs /var/lib/neo4j/import /var/
 COPY requirements.txt .
 RUN pip install --no-cache-dir -r requirements.txt
 
+# 复制启动脚本并设置权限
+COPY start.sh /app/start.sh
+RUN chmod +x /app/start.sh
+
 # 复制应用代码
 COPY . .
 
-# 创建启动脚本
-RUN echo '#!/bin/bash\n\
-set -e\n\
-\n\
-# 确保清理旧的数据（如果需要重新初始化）\n\
-if [ "$RESET_NEO4J" = "true" ]; then\n\
-    echo "Resetting Neo4j data..."\n\
-    rm -rf /var/lib/neo4j/data/databases/\n\
-    rm -rf /var/lib/neo4j/data/transactions/\n\
-fi\n\
-\n\
-# 设置 Neo4j 初始密码\n\
-echo "Setting up Neo4j initial password..."\n\
-if [ ! -f /var/lib/neo4j/data/.neo4j_initialized ]; then\n\
-    neo4j-admin dbms set-initial-password ${NEO4J_PASSWORD:-password}\n\
-    touch /var/lib/neo4j/data/.neo4j_initialized\n\
-else\n\
-    echo "Neo4j already initialized, skipping password setup"\n\
-fi\n\
-\n\
-# 启动 Neo4j\n\
-echo "Starting Neo4j..."\n\
-neo4j start\n\
-\n\
-# 等待 Neo4j 启动\n\
-echo "Waiting for Neo4j to start..."\n\
-for i in {1..30}; do\n\
-    if neo4j status > /dev/null 2>&1; then\n\
-        echo "Neo4j started successfully"\n\
-        break\n\
-    fi\n\
-    echo "Neo4j is starting... ($i/30)"\n\
-    sleep 2\n\
-done\n\
-\n\
-# 验证 Neo4j 是否真的启动了\n\
-if ! neo4j status > /dev/null 2>&1; then\n\
-    echo "Failed to start Neo4j after 60 seconds"\n\
-    exit 1\n\
-fi\n\
-\n\
-# 额外等待确保 Neo4j 完全就绪\n\
-echo "Waiting for Neo4j to be fully ready..."\n\
-sleep 5\n\
-\n\
-# 运行应用\n\
-echo "Starting Graphiti MCP Server..."\n\
-if [ -f "mcp_server.py" ]; then\n\
-    python mcp_server.py\n\
-elif [ -f "main.py" ]; then\n\
-    python main.py\n\
-elif [ -f "app.py" ]; then\n\
-    python app.py\n\
-else\n\
-    echo "No application file found. Starting Python shell..."\n\
-    python\n\
-fi\n\
-' > /app/start.sh && chmod +x /app/start.sh
-
 # 暴露端口
 EXPOSE 7474 7687 8000
 
@@ -106,4 +51,4 @@ HEALTHCHECK --interval=30s --timeout=10s --start-period=60s --retries=3 \
     CMD neo4j status && curl -f http://localhost:7474/ || exit 1
 
 # 启动命令
-CMD ["/app/start.sh"] 
+CMD ["./start.sh"] 

MCP_USAGE.md

@@ -18,10 +18,39 @@
 # 使用 Docker Compose
 docker-compose up -d
 
-# 或直接运行 MCP 服务器
+# 或直接运行启动脚本 (推荐)
+chmod +x start.sh
+./start.sh
+
+# 或仅运行 MCP 服务器 (需要 Neo4j 已启动)
 python mcp_server.py
 ```
 
+### 启动脚本说明
+
+`start.sh` 脚本会自动完成以下操作：
+
+1. **Neo4j 初始化和启动**
+   - 设置初始密码
+   - 启动 Neo4j 服务
+   - 等待服务就绪
+
+2. **MCP 服务器启动**  
+   - 启动 Graphiti MCP 服务器
+   - 等待客户端连接
+
+**环境变量配置:**
+```bash
+# 重置 Neo4j 数据 (开发环境)
+export RESET_NEO4J=true
+
+# 自定义 Neo4j 密码
+export NEO4J_PASSWORD=your_password
+
+# 启动脚本
+./start.sh
+```
+
 ### 2. 验证服务状态
 
 ```bash

README.md

@@ -318,10 +318,26 @@ This Docker deployment includes:
 - **Python 3.11**: Runtime environment
 - **Graphiti Core**: Knowledge graph framework
 - **MCP Server**: Model Context Protocol server implementation
+- **Start Script**: Automated startup script (`start.sh`) for Neo4j and MCP server
 - **Example Application**: Ready-to-run Graphiti demo with sample data
 - **Health Checks**: Container monitoring and status verification
 - **Data Persistence**: Volume mounting for data preservation
 
+### File Structure
+
+```
+graphiti-mcp/
+├── start.sh              # 启动脚本 (Neo4j + MCP Server)
+├── mcp_server.py          # MCP 协议服务器实现
+├── main.py                # Graphiti 示例应用
+├── requirements.txt       # Python 依赖
+├── Dockerfile             # Docker 镜像构建
+├── docker-compose.yml     # Docker Compose 配置
+├── env.example            # 环境变量示例
+├── README.md              # 项目文档
+└── MCP_USAGE.md           # MCP 使用指南
+```
+
 ## 🛠️ MCP Tools Available
 
 The Graphiti MCP server provides the following tools:
@@ -338,6 +354,46 @@ The Graphiti MCP server provides the following tools:
 - `graphiti://graph/schema` - 知识图谱架构信息
 - `graphiti://graph/stats` - 图谱统计信息
 
+## 🔧 启动脚本说明
+
+`start.sh` 脚本负责自动化启动流程，包含以下功能：
+
+### 启动流程
+
+1. **数据清理** (可选)
+   - 当设置 `RESET_NEO4J=true` 时，清理旧的 Neo4j 数据
+
+2. **Neo4j 初始化**
+   - 设置初始密码 (使用 `NEO4J_PASSWORD` 环境变量)
+   - 创建初始化标记文件
+
+3. **Neo4j 启动**
+   - 启动 Neo4j 服务
+   - 等待服务就绪 (最多30秒)
+   - 验证服务状态
+
+4. **应用启动**
+   - 优先启动 `mcp_server.py` (MCP 服务器)
+   - 备选启动 `main.py` 或 `app.py`
+
+### 环境变量
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `RESET_NEO4J` | 是否重置 Neo4j 数据 | `false` |
+| `NEO4J_PASSWORD` | Neo4j 密码 | `password` |
+
+### 手动运行
+
+```bash
+# 本地运行启动脚本
+chmod +x start.sh
+./start.sh
+
+# 或在容器中运行
+docker exec -it graphiti-mcp-server ./start.sh
+```
+
 ## 🚀 CI/CD Pipeline
 
 This repository includes GitHub Actions workflow that automatically:

start.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+set -e
+
+# 确保清理旧的数据（如果需要重新初始化）
+if [ "$RESET_NEO4J" = "true" ]; then
+    echo "Resetting Neo4j data..."
+    rm -rf /var/lib/neo4j/data/databases/
+    rm -rf /var/lib/neo4j/data/transactions/
+fi
+
+# 设置 Neo4j 初始密码
+echo "Setting up Neo4j initial password..."
+if [ ! -f /var/lib/neo4j/data/.neo4j_initialized ]; then
+    neo4j-admin dbms set-initial-password ${NEO4J_PASSWORD:-password}
+    touch /var/lib/neo4j/data/.neo4j_initialized
+else
+    echo "Neo4j already initialized, skipping password setup"
+fi
+
+# 启动 Neo4j
+echo "Starting Neo4j..."
+neo4j start
+
+# 等待 Neo4j 启动
+echo "Waiting for Neo4j to start..."
+for i in {1..30}; do
+    if neo4j status > /dev/null 2>&1; then
+        echo "Neo4j started successfully"
+        break
+    fi
+    echo "Neo4j is starting... ($i/30)"
+    sleep 2
+done
+
+# 验证 Neo4j 是否真的启动了
+if ! neo4j status > /dev/null 2>&1; then
+    echo "Failed to start Neo4j after 60 seconds"
+    exit 1
+fi
+
+# 额外等待确保 Neo4j 完全就绪
+echo "Waiting for Neo4j to be fully ready..."
+sleep 5
+
+# 运行应用
+echo "Starting Graphiti MCP Server..."
+if [ -f "mcp_server.py" ]; then
+    python mcp_server.py
+elif [ -f "main.py" ]; then
+    python main.py
+elif [ -f "app.py" ]; then
+    python app.py
+else
+    echo "No application file found. Starting Python shell..."
+    python
+fi